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,147 @@
/**
* File: array_binary_tree.js
* Created Time: 2023-08-06
* Author: yuan0221 (yl1452491917@gmail.com)
*/
const { arrToTree } = require('../modules/TreeNode');
const { printTree } = require('../modules/PrintUtil');
/* Класс двоичного дерева в массивном представлении */
class ArrayBinaryTree {
#tree;
/* Конструктор */
constructor(arr) {
this.#tree = arr;
}
/* Вместимость списка */
size() {
return this.#tree.length;
}
/* Получить значение узла с индексом i */
val(i) {
// Если индекс выходит за границы, вернуть null, обозначающий пустую позицию
if (i < 0 || i >= this.size()) return null;
return this.#tree[i];
}
/* Получить индекс левого дочернего узла узла с индексом i */
left(i) {
return 2 * i + 1;
}
/* Получить индекс правого дочернего узла узла с индексом i */
right(i) {
return 2 * i + 2;
}
/* Получить индекс родительского узла узла с индексом i */
parent(i) {
return Math.floor((i - 1) / 2); // Округление вниз при делении
}
/* Обход в ширину */
levelOrder() {
let res = [];
// Непосредственно обходить массив
for (let i = 0; i < this.size(); i++) {
if (this.val(i) !== null) res.push(this.val(i));
}
return res;
}
/* Обход в глубину */
#dfs(i, order, res) {
// Если это пустая позиция, вернуть
if (this.val(i) === null) return;
// Предварительный обход
if (order === 'pre') res.push(this.val(i));
this.#dfs(this.left(i), order, res);
// Симметричный обход
if (order === 'in') res.push(this.val(i));
this.#dfs(this.right(i), order, res);
// Обратный обход
if (order === 'post') res.push(this.val(i));
}
/* Предварительный обход */
preOrder() {
const res = [];
this.#dfs(0, 'pre', res);
return res;
}
/* Симметричный обход */
inOrder() {
const res = [];
this.#dfs(0, 'in', res);
return res;
}
/* Обратный обход */
postOrder() {
const res = [];
this.#dfs(0, 'post', res);
return res;
}
}
/* Driver Code */
// Инициализировать двоичное дерево
// Здесь используется функция, напрямую строящая двоичное дерево из массива
const arr = Array.of(
1,
2,
3,
4,
null,
6,
7,
8,
9,
null,
null,
12,
null,
null,
15
);
const root = arrToTree(arr);
console.log('\nИнициализация двоичного дерева\n');
console.log('Массивное представление двоичного дерева:');
console.log(arr);
console.log('Связное представление двоичного дерева:');
printTree(root);
// Класс двоичного дерева в массивном представлении
const abt = new ArrayBinaryTree(arr);
// Доступ к узлу
const i = 1;
const l = abt.left(i);
const r = abt.right(i);
const p = abt.parent(i);
console.log('\nТекущий узел: индекс = ' + i + ', значение = ' + abt.val(i));
console.log(
'Индекс левого дочернего узла = ' + l + ', значение = ' + (l === null ? 'null' : abt.val(l))
);
console.log(
'Индекс правого дочернего узла = ' + r + ', значение = ' + (r === null ? 'null' : abt.val(r))
);
console.log(
'Индекс родительского узла = ' + p + ', значение = ' + (p === null ? 'null' : abt.val(p))
);
// Обходить дерево
let res = abt.levelOrder();
console.log('\nОбход в ширину: ' + res);
res = abt.preOrder();
console.log('Предварительный обход: ' + res);
res = abt.inOrder();
console.log('Симметричный обход: ' + res);
res = abt.postOrder();
console.log('Обратный обход: ' + res);
@@ -0,0 +1,208 @@
/**
* File: avl_tree.js
* Created Time: 2023-02-05
* Author: what-is-me (whatisme@outlook.jp)
*/
const { TreeNode } = require('../modules/TreeNode');
const { printTree } = require('../modules/PrintUtil');
/* AVL-дерево */
class AVLTree {
/* Конструктор */
constructor() {
this.root = null; // Корневой узел
}
/* Получить высоту узла */
height(node) {
// Высота пустого узла равна -1, высота листового узла равна 0
return node === null ? -1 : node.height;
}
/* Обновить высоту узла */
#updateHeight(node) {
// Высота узла равна высоте более высокого поддерева + 1
node.height =
Math.max(this.height(node.left), this.height(node.right)) + 1;
}
/* Получить коэффициент баланса */
balanceFactor(node) {
// Коэффициент баланса пустого узла равен 0
if (node === null) return 0;
// Коэффициент баланса узла = высота левого поддерева - высота правого поддерева
return this.height(node.left) - this.height(node.right);
}
/* Операция правого вращения */
#rightRotate(node) {
const child = node.left;
const grandChild = child.right;
// Выполнить правое вращение узла node вокруг child
child.right = node;
node.left = grandChild;
// Обновить высоту узла
this.#updateHeight(node);
this.#updateHeight(child);
// Вернуть корневой узел поддерева после вращения
return child;
}
/* Операция левого вращения */
#leftRotate(node) {
const child = node.right;
const grandChild = child.left;
// Выполнить левое вращение узла node вокруг child
child.left = node;
node.right = grandChild;
// Обновить высоту узла
this.#updateHeight(node);
this.#updateHeight(child);
// Вернуть корневой узел поддерева после вращения
return child;
}
/* Выполнить вращение, чтобы снова сбалансировать поддерево */
#rotate(node) {
// Получить коэффициент баланса узла node
const balanceFactor = this.balanceFactor(node);
// Левосторонне перекошенное дерево
if (balanceFactor > 1) {
if (this.balanceFactor(node.left) >= 0) {
// Правое вращение
return this.#rightRotate(node);
} else {
// Сначала левое вращение, затем правое
node.left = this.#leftRotate(node.left);
return this.#rightRotate(node);
}
}
// Правосторонне перекошенное дерево
if (balanceFactor < -1) {
if (this.balanceFactor(node.right) <= 0) {
// Левое вращение
return this.#leftRotate(node);
} else {
// Сначала правое вращение, затем левое
node.right = this.#rightRotate(node.right);
return this.#leftRotate(node);
}
}
// Дерево сбалансировано, вращение не требуется, вернуть сразу
return node;
}
/* Вставка узла */
insert(val) {
this.root = this.#insertHelper(this.root, val);
}
/* Рекурсивная вставка узла (вспомогательный метод) */
#insertHelper(node, val) {
if (node === null) return new TreeNode(val);
/* 1. Найти позицию вставки и вставить узел */
if (val < node.val) node.left = this.#insertHelper(node.left, val);
else if (val > node.val)
node.right = this.#insertHelper(node.right, val);
else return node; // Повторяющийся узел не вставлять, сразу вернуть
this.#updateHeight(node); // Обновить высоту узла
/* 2. Выполнить вращение, чтобы снова сбалансировать поддерево */
node = this.#rotate(node);
// Вернуть корневой узел поддерева
return node;
}
/* Удаление узла */
remove(val) {
this.root = this.#removeHelper(this.root, val);
}
/* Рекурсивное удаление узла (вспомогательный метод) */
#removeHelper(node, val) {
if (node === null) return null;
/* 1. Найти узел и удалить его */
if (val < node.val) node.left = this.#removeHelper(node.left, val);
else if (val > node.val)
node.right = this.#removeHelper(node.right, val);
else {
if (node.left === null || node.right === null) {
const child = node.left !== null ? node.left : node.right;
// Число дочерних узлов = 0, удалить node и сразу вернуть
if (child === null) return null;
// Число дочерних узлов = 1, удалить node напрямую
else node = child;
} else {
// Число дочерних узлов = 2, удалить следующий по симметричному обходу узел и заменить им текущий узел
let temp = node.right;
while (temp.left !== null) {
temp = temp.left;
}
node.right = this.#removeHelper(node.right, temp.val);
node.val = temp.val;
}
}
this.#updateHeight(node); // Обновить высоту узла
/* 2. Выполнить вращение, чтобы снова сбалансировать поддерево */
node = this.#rotate(node);
// Вернуть корневой узел поддерева
return node;
}
/* Поиск узла */
search(val) {
let cur = this.root;
// Искать в цикле и выйти после прохода за листовой узел
while (cur !== null) {
// Целевой узел находится в правом поддереве cur
if (cur.val < val) cur = cur.right;
// Целевой узел находится в левом поддереве cur
else if (cur.val > val) cur = cur.left;
// Найти целевой узел и выйти из цикла
else break;
}
// Вернуть целевой узел
return cur;
}
}
function testInsert(tree, val) {
tree.insert(val);
console.log('\nПосле вставки узла ' + val + ' AVL-дерево имеет вид');
printTree(tree.root);
}
function testRemove(tree, val) {
tree.remove(val);
console.log('\nПосле удаления узла ' + val + ' AVL-дерево имеет вид');
printTree(tree.root);
}
/* Driver Code */
/* Инициализация пустого AVL-дерева */
const avlTree = new 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
/* Поиск узла */
const node = avlTree.search(7);
console.log('\nНайденный объект узла =', node, ', значение узла = ' + node.val);
@@ -0,0 +1,139 @@
/**
* File: binary_search_tree.js
* Created Time: 2022-12-04
* Author: IsChristina (christinaxia77@foxmail.com)
*/
const { TreeNode } = require('../modules/TreeNode');
const { printTree } = require('../modules/PrintUtil');
/* Двоичное дерево поиска */
class BinarySearchTree {
/* Конструктор */
constructor() {
// Инициализировать пустое дерево
this.root = null;
}
/* Получить корневой узел двоичного дерева */
getRoot() {
return this.root;
}
/* Поиск узла */
search(num) {
let cur = this.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;
}
/* Вставка узла */
insert(num) {
// Если дерево пусто, инициализировать корневой узел
if (this.root === null) {
this.root = new TreeNode(num);
return;
}
let cur = this.root,
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;
}
// Вставка узла
const node = new TreeNode(num);
if (pre.val < num) pre.right = node;
else pre.left = node;
}
/* Удаление узла */
remove(num) {
// Если дерево пусто, сразу вернуть
if (this.root === null) return;
let cur = this.root,
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 / этот дочерний узел
const child = cur.left !== null ? cur.left : cur.right;
// Удалить узел cur
if (cur !== this.root) {
if (pre.left === cur) pre.left = child;
else pre.right = child;
} else {
// Если удаляемый узел является корнем, заново назначить корневой узел
this.root = child;
}
}
// Число дочерних узлов = 2
else {
// Получить следующий узел после cur в симметричном обходе
let tmp = cur.right;
while (tmp.left !== null) {
tmp = tmp.left;
}
// Рекурсивно удалить узел tmp
this.remove(tmp.val);
// Перезаписать cur значением tmp
cur.val = tmp.val;
}
}
}
/* Driver Code */
/* Инициализация двоичного дерева поиска */
const bst = new BinarySearchTree();
// Обратите внимание: разные порядки вставки порождают разные двоичные деревья; данная последовательность может построить совершенное двоичное дерево
const nums = [8, 4, 12, 2, 6, 10, 14, 1, 3, 5, 7, 9, 11, 13, 15];
for (const num of nums) {
bst.insert(num);
}
console.log('\nИсходное двоичное дерево\n');
printTree(bst.getRoot());
/* Поиск узла */
const node = bst.search(7);
console.log('\nНайденный объект узла = ' + node + ', значение узла = ' + node.val);
/* Вставка узла */
bst.insert(16);
console.log('\nПосле вставки узла 16 двоичное дерево имеет вид\n');
printTree(bst.getRoot());
/* Удаление узла */
bst.remove(1);
console.log('\nПосле удаления узла 1 двоичное дерево имеет вид\n');
printTree(bst.getRoot());
bst.remove(2);
console.log('\nПосле удаления узла 2 двоичное дерево имеет вид\n');
printTree(bst.getRoot());
bst.remove(4);
console.log('\nПосле удаления узла 4 двоичное дерево имеет вид\n');
printTree(bst.getRoot());
@@ -0,0 +1,35 @@
/**
* File: binary_tree.js
* Created Time: 2022-12-04
* Author: IsChristina (christinaxia77@foxmail.com)
*/
const { TreeNode } = require('../modules/TreeNode');
const { printTree } = require('../modules/PrintUtil');
/* Инициализация двоичного дерева */
// Инициализация узла
let n1 = new TreeNode(1),
n2 = new TreeNode(2),
n3 = new TreeNode(3),
n4 = new TreeNode(4),
n5 = new TreeNode(5);
// Построить связи между узлами (указатели)
n1.left = n2;
n1.right = n3;
n2.left = n4;
n2.right = n5;
console.log('\nИнициализация двоичного дерева\n');
printTree(n1);
/* Вставка и удаление узлов */
const P = new TreeNode(0);
// Вставить узел P между n1 -> n2
n1.left = P;
P.left = n2;
console.log('\nПосле вставки узла P\n');
printTree(n1);
// Удалить узел P
n1.left = n2;
console.log('\nПосле удаления узла P\n');
printTree(n1);
@@ -0,0 +1,34 @@
/**
* File: binary_tree_bfs.js
* Created Time: 2022-12-04
* Author: IsChristina (christinaxia77@foxmail.com)
*/
const { arrToTree } = require('../modules/TreeNode');
const { printTree } = require('../modules/PrintUtil');
/* Обход в ширину */
function levelOrder(root) {
// Инициализировать очередь и добавить корневой узел
const queue = [root];
// Инициализировать список для хранения последовательности обхода
const list = [];
while (queue.length) {
let node = queue.shift(); // Извлечение из очереди
list.push(node.val); // Сохранить значение узла
if (node.left) queue.push(node.left); // Поместить левый дочерний узел в очередь
if (node.right) queue.push(node.right); // Поместить правый дочерний узел в очередь
}
return list;
}
/* Driver Code */
/* Инициализация двоичного дерева */
// Здесь используется функция, напрямую строящая двоичное дерево из массива
const root = arrToTree([1, 2, 3, 4, 5, 6, 7]);
console.log('\nИнициализация двоичного дерева\n');
printTree(root);
/* Обход в ширину */
const list = levelOrder(root);
console.log('\nПоследовательность печати узлов при обходе в ширину = ' + list);
@@ -0,0 +1,60 @@
/**
* File: binary_tree_dfs.js
* Created Time: 2022-12-04
* Author: IsChristina (christinaxia77@foxmail.com)
*/
const { arrToTree } = require('../modules/TreeNode');
const { printTree } = require('../modules/PrintUtil');
// Инициализировать список для хранения последовательности обхода
const list = [];
/* Предварительный обход */
function preOrder(root) {
if (root === null) return;
// Порядок обхода: корень -> левое поддерево -> правое поддерево
list.push(root.val);
preOrder(root.left);
preOrder(root.right);
}
/* Симметричный обход */
function inOrder(root) {
if (root === null) return;
// Порядок обхода: левое поддерево -> корень -> правое поддерево
inOrder(root.left);
list.push(root.val);
inOrder(root.right);
}
/* Обратный обход */
function postOrder(root) {
if (root === null) return;
// Порядок обхода: левое поддерево -> правое поддерево -> корень
postOrder(root.left);
postOrder(root.right);
list.push(root.val);
}
/* Driver Code */
/* Инициализация двоичного дерева */
// Здесь используется функция, напрямую строящая двоичное дерево из массива
const root = arrToTree([1, 2, 3, 4, 5, 6, 7]);
console.log('\nИнициализация двоичного дерева\n');
printTree(root);
/* Предварительный обход */
list.length = 0;
preOrder(root);
console.log('\nПоследовательность печати узлов при предварительном обходе = ' + list);
/* Симметричный обход */
list.length = 0;
inOrder(root);
console.log('\nПоследовательность печати узлов при симметричном обходе = ' + list);
/* Обратный обход */
list.length = 0;
postOrder(root);
console.log('\nПоследовательность печати узлов при обратном обходе = ' + list);