Add ru version (#1865)

* Add Russian docs site baseline

* Add Russian localized codebase

* Polish Russian code wording

* Update ru code translation.

* Update code translation and chapter covers.

* Fix pythontutor extraction.

* Add README and landing page.

* placeholder of profiles

* Use figures of English version

* Remove chapter paperbook
This commit is contained in:
Yudong Jin
2026-03-28 04:24:07 +08:00
committed by GitHub
parent 2ca570cc33
commit 772183705e
1958 changed files with 108186 additions and 0 deletions
@@ -0,0 +1,152 @@
/**
* File: array_binary_tree.dart
* Created Time: 2023-08-15
* Author: liuyuxin (gvenusleo@gmail.com)
*/
import '../utils/print_util.dart';
import '../utils/tree_node.dart';
/* Класс двоичного дерева в массивном представлении */
class ArrayBinaryTree {
late List<int?> _tree;
/* Конструктор */
ArrayBinaryTree(this._tree);
/* Вместимость списка */
int size() {
return _tree.length;
}
/* Получить значение узла с индексом i */
int? val(int i) {
// Если индекс выходит за границы, вернуть null, обозначающий пустую позицию
if (i < 0 || i >= size()) {
return null;
}
return _tree[i];
}
/* Получить индекс левого дочернего узла узла с индексом i */
int? left(int i) {
return 2 * i + 1;
}
/* Получить индекс правого дочернего узла узла с индексом i */
int? right(int i) {
return 2 * i + 2;
}
/* Получить индекс родительского узла узла с индексом i */
int? parent(int i) {
return (i - 1) ~/ 2;
}
/* Обход в ширину */
List<int> levelOrder() {
List<int> res = [];
for (int i = 0; i < size(); i++) {
if (val(i) != null) {
res.add(val(i)!);
}
}
return res;
}
/* Обход в глубину */
void dfs(int i, String order, List<int?> res) {
// Если это пустая позиция, вернуть
if (val(i) == null) {
return;
}
// Предварительный обход
if (order == 'pre') {
res.add(val(i));
}
dfs(left(i)!, order, res);
// Симметричный обход
if (order == 'in') {
res.add(val(i));
}
dfs(right(i)!, order, res);
// Обратный обход
if (order == 'post') {
res.add(val(i));
}
}
/* Предварительный обход */
List<int?> preOrder() {
List<int?> res = [];
dfs(0, 'pre', res);
return res;
}
/* Симметричный обход */
List<int?> inOrder() {
List<int?> res = [];
dfs(0, 'in', res);
return res;
}
/* Обратный обход */
List<int?> postOrder() {
List<int?> res = [];
dfs(0, 'post', res);
return res;
}
}
/* Driver Code */
void main() {
// Инициализировать двоичное дерево
// Здесь используется функция, напрямую строящая двоичное дерево из массива
List<int?> arr = [
1,
2,
3,
4,
null,
6,
7,
8,
9,
null,
null,
12,
null,
null,
15
];
TreeNode? root = listToTree(arr);
print("\nИнициализация двоичного дерева\n");
print("Массивное представление двоичного дерева:");
print(arr);
print("Связное представление двоичного дерева:");
printTree(root);
// Класс двоичного дерева в массивном представлении
ArrayBinaryTree abt = ArrayBinaryTree(arr);
// Доступ к узлу
int i = 1;
int? l = abt.left(i);
int? r = abt.right(i);
int? p = abt.parent(i);
print("\nТекущий узел: индекс = $i, значение = ${abt.val(i)}");
print("Индекс левого дочернего узла = $l, значение = ${(l == null ? "null" : abt.val(l))}");
print("Индекс правого дочернего узла = $r, значение = ${(r == null ? "null" : abt.val(r))}");
print("Индекс родительского узла = $p, значение = ${(p == null ? "null" : abt.val(p))}");
// Обходить дерево
List<int?> res = abt.levelOrder();
print("\nОбход в ширину = $res");
res = abt.preOrder();
print("Предварительный обход = $res");
res = abt.inOrder();
print("Симметричный обход = $res");
res = abt.postOrder();
print("Обратный обход = $res");
}
+218
View File
@@ -0,0 +1,218 @@
/**
* File: avl_tree.dart
* Created Time: 2023-04-04
* Author: liuyuxin (gvenusleo@gmail.com)
*/
import 'dart:math';
import '../utils/print_util.dart';
import '../utils/tree_node.dart';
class AVLTree {
TreeNode? root;
/* Конструктор */
AVLTree() {
root = null;
}
/* Получить высоту узла */
int height(TreeNode? node) {
// Высота пустого узла равна -1, высота листового узла равна 0
return node == null ? -1 : node.height;
}
/* Обновить высоту узла */
void updateHeight(TreeNode? node) {
// Высота узла равна высоте более высокого поддерева + 1
node!.height = max(height(node.left), height(node.right)) + 1;
}
/* Получить коэффициент баланса */
int balanceFactor(TreeNode? node) {
// Коэффициент баланса пустого узла равен 0
if (node == null) return 0;
// Коэффициент баланса узла = высота левого поддерева - высота правого поддерева
return height(node.left) - height(node.right);
}
/* Операция правого вращения */
TreeNode? rightRotate(TreeNode? node) {
TreeNode? child = node!.left;
TreeNode? grandChild = child!.right;
// Выполнить правое вращение узла node вокруг child
child.right = node;
node.left = grandChild;
// Обновить высоту узла
updateHeight(node);
updateHeight(child);
// Вернуть корневой узел поддерева после вращения
return child;
}
/* Операция левого вращения */
TreeNode? leftRotate(TreeNode? node) {
TreeNode? child = node!.right;
TreeNode? grandChild = child!.left;
// Выполнить левое вращение узла node вокруг child
child.left = node;
node.right = grandChild;
// Обновить высоту узла
updateHeight(node);
updateHeight(child);
// Вернуть корневой узел поддерева после вращения
return child;
}
/* Выполнить вращение, чтобы снова сбалансировать поддерево */
TreeNode? rotate(TreeNode? node) {
// Получить коэффициент баланса узла node
int factor = balanceFactor(node);
// Левосторонне перекошенное дерево
if (factor > 1) {
if (balanceFactor(node!.left) >= 0) {
// Правое вращение
return rightRotate(node);
} else {
// Сначала левое вращение, затем правое
node.left = leftRotate(node.left);
return rightRotate(node);
}
}
// Правосторонне перекошенное дерево
if (factor < -1) {
if (balanceFactor(node!.right) <= 0) {
// Левое вращение
return leftRotate(node);
} else {
// Сначала правое вращение, затем левое
node.right = rightRotate(node.right);
return leftRotate(node);
}
}
// Дерево сбалансировано, вращение не требуется, вернуть сразу
return node;
}
/* Вставка узла */
void insert(int val) {
root = insertHelper(root, val);
}
/* Рекурсивная вставка узла (вспомогательный метод) */
TreeNode? insertHelper(TreeNode? node, int val) {
if (node == null) return TreeNode(val);
/* 1. Найти позицию вставки и вставить узел */
if (val < node.val)
node.left = insertHelper(node.left, val);
else if (val > node.val)
node.right = insertHelper(node.right, val);
else
return node; // Повторяющийся узел не вставлять, сразу вернуть
updateHeight(node); // Обновить высоту узла
/* 2. Выполнить вращение, чтобы снова сбалансировать поддерево */
node = rotate(node);
// Вернуть корневой узел поддерева
return node;
}
/* Удаление узла */
void remove(int val) {
root = removeHelper(root, val);
}
/* Рекурсивное удаление узла (вспомогательный метод) */
TreeNode? removeHelper(TreeNode? node, int val) {
if (node == null) return null;
/* 1. Найти узел и удалить его */
if (val < node.val)
node.left = removeHelper(node.left, val);
else if (val > node.val)
node.right = removeHelper(node.right, val);
else {
if (node.left == null || node.right == null) {
TreeNode? child = node.left ?? node.right;
// Число дочерних узлов = 0, удалить node и сразу вернуть
if (child == null)
return null;
// Число дочерних узлов = 1, удалить node напрямую
else
node = child;
} else {
// Число дочерних узлов = 2, удалить следующий по симметричному обходу узел и заменить им текущий узел
TreeNode? temp = node.right;
while (temp!.left != null) {
temp = temp.left;
}
node.right = removeHelper(node.right, temp.val);
node.val = temp.val;
}
}
updateHeight(node); // Обновить высоту узла
/* 2. Выполнить вращение, чтобы снова сбалансировать поддерево */
node = rotate(node);
// Вернуть корневой узел поддерева
return node;
}
/* Поиск узла */
TreeNode? search(int val) {
TreeNode? cur = root;
// Искать в цикле и выйти после прохода за листовой узел
while (cur != null) {
// Целевой узел находится в правом поддереве cur
if (val < cur.val)
cur = cur.left;
// Целевой узел находится в левом поддереве cur
else if (val > cur.val)
cur = cur.right;
// Целевой узел равен текущему узлу
else
break;
}
return cur;
}
}
void testInsert(AVLTree tree, int val) {
tree.insert(val);
print("\nПосле вставки узла $val AVL-дерево имеет вид");
printTree(tree.root);
}
void testRemove(AVLTree tree, int val) {
tree.remove(val);
print("\nПосле удаления узла $val AVL-дерево имеет вид");
printTree(tree.root);
}
/* Driver Code */
void main() {
/* Инициализация пустого AVL-дерева */
AVLTree avlTree = AVLTree();
/* Вставка узла */
// Обратите внимание, как AVL-дерево сохраняет баланс после вставки узла
testInsert(avlTree, 1);
testInsert(avlTree, 2);
testInsert(avlTree, 3);
testInsert(avlTree, 4);
testInsert(avlTree, 5);
testInsert(avlTree, 8);
testInsert(avlTree, 7);
testInsert(avlTree, 9);
testInsert(avlTree, 10);
testInsert(avlTree, 6);
/* Вставка повторяющегося узла */
testInsert(avlTree, 7);
/* Удаление узла */
// Обратите внимание, как AVL-дерево сохраняет баланс после удаления узла
testRemove(avlTree, 8); // Удаление узла степени 0
testRemove(avlTree, 5); // Удаление узла степени 1
testRemove(avlTree, 4); // Удаление узла степени 2
/* Поиск узла */
TreeNode? node = avlTree.search(7);
print("\nНайденный объект узла = $node, значение узла = ${node!.val}");
}
@@ -0,0 +1,153 @@
/**
* File: binary_search_tree.dart
* Created Time: 2023-04-04
* Author: liuyuxin (gvenusleo@gmail.com)
*/
import '../utils/print_util.dart';
import '../utils/tree_node.dart';
/* Двоичное дерево поиска */
class BinarySearchTree {
late TreeNode? _root;
/* Конструктор */
BinarySearchTree() {
// Инициализировать пустое дерево
_root = null;
}
/* Получить корневой узел двоичного дерева */
TreeNode? getRoot() {
return _root;
}
/* Поиск узла */
TreeNode? search(int _num) {
TreeNode? cur = _root;
// Искать в цикле и выйти после прохода за листовой узел
while (cur != null) {
// Целевой узел находится в правом поддереве cur
if (cur.val < _num)
cur = cur.right;
// Целевой узел находится в левом поддереве cur
else if (cur.val > _num)
cur = cur.left;
// Найти целевой узел и выйти из цикла
else
break;
}
// Вернуть целевой узел
return cur;
}
/* Вставка узла */
void insert(int _num) {
// Если дерево пусто, инициализировать корневой узел
if (_root == null) {
_root = TreeNode(_num);
return;
}
TreeNode? cur = _root;
TreeNode? pre = null;
// Искать в цикле и выйти после прохода за листовой узел
while (cur != null) {
// Найти повторяющийся узел и сразу вернуть
if (cur.val == _num) return;
pre = cur;
// Позиция вставки находится в правом поддереве cur
if (cur.val < _num)
cur = cur.right;
// Позиция вставки находится в левом поддереве cur
else
cur = cur.left;
}
// Вставка узла
TreeNode? node = TreeNode(_num);
if (pre!.val < _num)
pre.right = node;
else
pre.left = node;
}
/* Удаление узла */
void remove(int _num) {
// Если дерево пусто, сразу вернуть
if (_root == null) return;
TreeNode? cur = _root;
TreeNode? pre = null;
// Искать в цикле и выйти после прохода за листовой узел
while (cur != null) {
// Найти узел для удаления и выйти из цикла
if (cur.val == _num) break;
pre = cur;
// Узел для удаления находится в правом поддереве cur
if (cur.val < _num)
cur = cur.right;
// Узел для удаления находится в левом поддереве cur
else
cur = cur.left;
}
// Если удаляемого узла нет, сразу вернуть
if (cur == null) return;
// Число дочерних узлов = 0 или 1
if (cur.left == null || cur.right == null) {
// Когда число дочерних узлов = 0 / 1, child = null / этот дочерний узел
TreeNode? child = cur.left ?? cur.right;
// Удалить узел cur
if (cur != _root) {
if (pre!.left == cur)
pre.left = child;
else
pre.right = child;
} else {
// Если удаляемый узел является корнем, заново назначить корневой узел
_root = child;
}
} else {
// Число дочерних узлов = 2
// Получить следующий узел после cur в симметричном обходе
TreeNode? tmp = cur.right;
while (tmp!.left != null) {
tmp = tmp.left;
}
// Рекурсивно удалить узел tmp
remove(tmp.val);
// Перезаписать cur значением tmp
cur.val = tmp.val;
}
}
}
/* Driver Code */
void main() {
/* Инициализация двоичного дерева поиска */
BinarySearchTree bst = BinarySearchTree();
// Обратите внимание: разные порядки вставки порождают разные двоичные деревья; данная последовательность может построить совершенное двоичное дерево
List<int> nums = [8, 4, 12, 2, 6, 10, 14, 1, 3, 5, 7, 9, 11, 13, 15];
for (int _num in nums) {
bst.insert(_num);
}
print("\nИсходное двоичное дерево\n");
printTree(bst.getRoot());
/* Поиск узла */
TreeNode? node = bst.search(7);
print("\nНайденный объект узла = $node, значение узла = ${node?.val}");
/* Вставка узла */
bst.insert(16);
print("\nПосле вставки узла 16 двоичное дерево имеет вид\n");
printTree(bst.getRoot());
/* Удаление узла */
bst.remove(1);
print("\nПосле удаления узла 1 двоичное дерево имеет вид\n");
printTree(bst.getRoot());
bst.remove(2);
print("\nПосле удаления узла 2 двоичное дерево имеет вид\n");
printTree(bst.getRoot());
bst.remove(4);
print("\nПосле удаления узла 4 двоичное дерево имеет вид\n");
printTree(bst.getRoot());
}
@@ -0,0 +1,37 @@
/**
* File: binary_tree.dart
* Created Time: 2023-04-03
* Author: liuyuxin (gvenusleo@gmail.com)
*/
import '../utils/print_util.dart';
import '../utils/tree_node.dart';
void main() {
/* Инициализация двоичного дерева */
// Инициализировать узлы дерева
TreeNode n1 = TreeNode(1);
TreeNode n2 = TreeNode(2);
TreeNode n3 = TreeNode(3);
TreeNode n4 = TreeNode(4);
TreeNode n5 = TreeNode(5);
// Построить связи между узлами (указатели)
n1.left = n2;
n1.right = n3;
n2.left = n4;
n2.right = n5;
print("\nИнициализация двоичного дерева\n");
printTree(n1);
/* Вставка и удаление узлов */
TreeNode p = TreeNode(0);
// Вставить узел p между n1 -> n2
n1.left = p;
p.left = n2;
print("\nПосле вставки узла P\n");
printTree(n1);
// Удалить узел P
n1.left = n2;
print("\nПосле удаления узла P\n");
printTree(n1);
}
@@ -0,0 +1,38 @@
/**
* File: binary_tree_bfs.dart
* Created Time: 2023-04-03
* Author: liuyuxin (gvenusleo@gmai.com)
*/
import 'dart:collection';
import '../utils/print_util.dart';
import '../utils/tree_node.dart';
/* Обход в ширину */
List<int> levelOrder(TreeNode? root) {
// Инициализировать очередь и добавить корневой узел
Queue<TreeNode?> queue = Queue();
queue.add(root);
// Инициализировать список для хранения последовательности обхода
List<int> res = [];
while (queue.isNotEmpty) {
TreeNode? node = queue.removeFirst(); // Извлечение из очереди
res.add(node!.val); // Сохранить значение узла
if (node.left != null) queue.add(node.left); // Поместить левый дочерний узел в очередь
if (node.right != null) queue.add(node.right); // Поместить правый дочерний узел в очередь
}
return res;
}
/* Driver Code */
void main() {
/* Инициализация двоичного дерева */
// Здесь используется функция, напрямую строящая двоичное дерево из массива
TreeNode? root = listToTree([1, 2, 3, 4, 5, 6, 7]);
print("\nИнициализация двоичного дерева\n");
printTree(root);
// Обход в ширину
List<int> res = levelOrder(root);
print("\nПоследовательность печати узлов при обходе в ширину = $res");
}
@@ -0,0 +1,62 @@
/**
* File: binary_tree_dfs.dart
* Created Time: 2023-04-04
* Author: liuyuxin (gvenusleo@gmail.com)
*/
import '../utils/print_util.dart';
import '../utils/tree_node.dart';
// Инициализировать список для хранения последовательности обхода
List<int> list = [];
/* Предварительный обход */
void preOrder(TreeNode? node) {
if (node == null) return;
// Порядок обхода: корень -> левое поддерево -> правое поддерево
list.add(node.val);
preOrder(node.left);
preOrder(node.right);
}
/* Симметричный обход */
void inOrder(TreeNode? node) {
if (node == null) return;
// Порядок обхода: левое поддерево -> корень -> правое поддерево
inOrder(node.left);
list.add(node.val);
inOrder(node.right);
}
/* Обратный обход */
void postOrder(TreeNode? node) {
if (node == null) return;
// Порядок обхода: левое поддерево -> правое поддерево -> корень
postOrder(node.left);
postOrder(node.right);
list.add(node.val);
}
/* Driver Code */
void main() {
/* Инициализация двоичного дерева */
// Здесь используется функция, напрямую строящая двоичное дерево из массива
TreeNode? root = listToTree([1, 2, 3, 4, 5, 6, 7]);
print("\nИнициализация двоичного дерева\n");
printTree(root);
/* Предварительный обход */
list.clear();
preOrder(root);
print("\nПоследовательность печати узлов при предварительном обходе = $list");
/* Симметричный обход */
list.clear();
inOrder(root);
print("\nПоследовательность печати узлов при симметричном обходе = $list");
/* Обратный обход */
list.clear();
postOrder(root);
print("\nПоследовательность печати узлов при обратном обходе = $list");
}