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
+6
View File
@@ -0,0 +1,6 @@
add_executable(avl_tree avl_tree.c)
add_executable(binary_tree binary_tree.c)
add_executable(binary_tree_bfs binary_tree_bfs.c)
add_executable(binary_tree_dfs binary_tree_dfs.c)
add_executable(binary_search_tree binary_search_tree.c)
add_executable(array_binary_tree array_binary_tree.c)
+166
View File
@@ -0,0 +1,166 @@
/**
* File: array_binary_tree.c
* Created Time: 2023-07-29
* Author: Gonglja (glj0@outlook.com)
*/
#include "../utils/common.h"
/* Структура двоичного дерева в представлении массивом */
typedef struct {
int *tree;
int size;
} ArrayBinaryTree;
/* Конструктор */
ArrayBinaryTree *newArrayBinaryTree(int *arr, int arrSize) {
ArrayBinaryTree *abt = (ArrayBinaryTree *)malloc(sizeof(ArrayBinaryTree));
abt->tree = malloc(sizeof(int) * arrSize);
memcpy(abt->tree, arr, sizeof(int) * arrSize);
abt->size = arrSize;
return abt;
}
/* Деструктор */
void delArrayBinaryTree(ArrayBinaryTree *abt) {
free(abt->tree);
free(abt);
}
/* Вместимость списка */
int size(ArrayBinaryTree *abt) {
return abt->size;
}
/* Получить значение узла с индексом i */
int val(ArrayBinaryTree *abt, int i) {
// Если индекс выходит за границы, вернуть INT_MAX, обозначающий пустую позицию
if (i < 0 || i >= size(abt))
return INT_MAX;
return abt->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;
}
/* Обход в ширину */
int *levelOrder(ArrayBinaryTree *abt, int *returnSize) {
int *res = (int *)malloc(sizeof(int) * size(abt));
int index = 0;
// Непосредственно обходить массив
for (int i = 0; i < size(abt); i++) {
if (val(abt, i) != INT_MAX)
res[index++] = val(abt, i);
}
*returnSize = index;
return res;
}
/* Обход в глубину */
void dfs(ArrayBinaryTree *abt, int i, char *order, int *res, int *index) {
// Если это пустая позиция, вернуть
if (val(abt, i) == INT_MAX)
return;
// Предварительный обход
if (strcmp(order, "pre") == 0)
res[(*index)++] = val(abt, i);
dfs(abt, left(i), order, res, index);
// Симметричный обход
if (strcmp(order, "in") == 0)
res[(*index)++] = val(abt, i);
dfs(abt, right(i), order, res, index);
// Обратный обход
if (strcmp(order, "post") == 0)
res[(*index)++] = val(abt, i);
}
/* Предварительный обход */
int *preOrder(ArrayBinaryTree *abt, int *returnSize) {
int *res = (int *)malloc(sizeof(int) * size(abt));
int index = 0;
dfs(abt, 0, "pre", res, &index);
*returnSize = index;
return res;
}
/* Симметричный обход */
int *inOrder(ArrayBinaryTree *abt, int *returnSize) {
int *res = (int *)malloc(sizeof(int) * size(abt));
int index = 0;
dfs(abt, 0, "in", res, &index);
*returnSize = index;
return res;
}
/* Обратный обход */
int *postOrder(ArrayBinaryTree *abt, int *returnSize) {
int *res = (int *)malloc(sizeof(int) * size(abt));
int index = 0;
dfs(abt, 0, "post", res, &index);
*returnSize = index;
return res;
}
/* Driver Code */
int main() {
// Инициализировать двоичное дерево
// Использовать INT_MAX для обозначения пустой позиции NULL
int arr[] = {1, 2, 3, 4, INT_MAX, 6, 7, 8, 9, INT_MAX, INT_MAX, 12, INT_MAX, INT_MAX, 15};
int arrSize = sizeof(arr) / sizeof(arr[0]);
TreeNode *root = arrayToTree(arr, arrSize);
printf("\nИнициализация двоичного дерева\n");
printf("Массивное представление двоичного дерева:\n");
printArray(arr, arrSize);
printf("Связное представление двоичного дерева:\n");
printTree(root);
ArrayBinaryTree *abt = newArrayBinaryTree(arr, arrSize);
// Доступ к узлу
int i = 1;
int l = left(i), r = right(i), p = parent(i);
printf("\nТекущий индекс узла = %d, значение = %d\n", i, val(abt, i));
printf("Индекс левого дочернего узла = %d, значение = %d\n", l, l < arrSize ? val(abt, l) : INT_MAX);
printf("Индекс правого дочернего узла = %d, значение = %d\n", r, r < arrSize ? val(abt, r) : INT_MAX);
printf("Индекс родительского узла = %d, значение = %d\n", p, p < arrSize ? val(abt, p) : INT_MAX);
// Обходить дерево
int returnSize;
int *res;
res = levelOrder(abt, &returnSize);
printf("\nОбход по уровням: ");
printArray(res, returnSize);
free(res);
res = preOrder(abt, &returnSize);
printf("Предварительный обход: ");
printArray(res, returnSize);
free(res);
res = inOrder(abt, &returnSize);
printf("Симметричный обход: ");
printArray(res, returnSize);
free(res);
res = postOrder(abt, &returnSize);
printf("Обратный обход: ");
printArray(res, returnSize);
free(res);
// Освободить память
delArrayBinaryTree(abt);
return 0;
}
+259
View File
@@ -0,0 +1,259 @@
/**
* File: avl_tree.c
* Created Time: 2023-01-15
* Author: Reanon (793584285@qq.com)
*/
#include "../utils/common.h"
/* Структура AVL-дерева */
typedef struct {
TreeNode *root;
} AVLTree;
/* Конструктор */
AVLTree *newAVLTree() {
AVLTree *tree = (AVLTree *)malloc(sizeof(AVLTree));
tree->root = NULL;
return tree;
}
/* Деструктор */
void delAVLTree(AVLTree *tree) {
freeMemoryTree(tree->root);
free(tree);
}
/* Получить высоту узла */
int height(TreeNode *node) {
// Высота пустого узла равна -1, высота листового узла равна 0
if (node != NULL) {
return node->height;
}
return -1;
}
/* Обновить высоту узла */
void updateHeight(TreeNode *node) {
int lh = height(node->left);
int rh = height(node->right);
// Высота узла равна высоте более высокого поддерева + 1
if (lh > rh) {
node->height = lh + 1;
} else {
node->height = rh + 1;
}
}
/* Получить коэффициент баланса */
int balanceFactor(TreeNode *node) {
// Коэффициент баланса пустого узла равен 0
if (node == NULL) {
return 0;
}
// Коэффициент баланса узла = высота левого поддерева - высота правого поддерева
return height(node->left) - height(node->right);
}
/* Операция правого вращения */
TreeNode *rightRotate(TreeNode *node) {
TreeNode *child, *grandChild;
child = node->left;
grandChild = child->right;
// Выполнить правое вращение узла node вокруг child
child->right = node;
node->left = grandChild;
// Обновить высоту узла
updateHeight(node);
updateHeight(child);
// Вернуть корневой узел поддерева после вращения
return child;
}
/* Операция левого вращения */
TreeNode *leftRotate(TreeNode *node) {
TreeNode *child, *grandChild;
child = node->right;
grandChild = child->left;
// Выполнить левое вращение узла node вокруг child
child->left = node;
node->right = grandChild;
// Обновить высоту узла
updateHeight(node);
updateHeight(child);
// Вернуть корневой узел поддерева после вращения
return child;
}
/* Выполнить вращение, чтобы снова сбалансировать поддерево */
TreeNode *rotate(TreeNode *node) {
// Получить коэффициент баланса узла node
int bf = balanceFactor(node);
// Левосторонне перекошенное дерево
if (bf > 1) {
if (balanceFactor(node->left) >= 0) {
// Правое вращение
return rightRotate(node);
} else {
// Сначала левое вращение, затем правое
node->left = leftRotate(node->left);
return rightRotate(node);
}
}
// Правосторонне перекошенное дерево
if (bf < -1) {
if (balanceFactor(node->right) <= 0) {
// Левое вращение
return leftRotate(node);
} else {
// Сначала правое вращение, затем левое
node->right = rightRotate(node->right);
return leftRotate(node);
}
}
// Дерево сбалансировано, вращение не требуется, вернуть сразу
return node;
}
/* Рекурсивная вставка узла (вспомогательная функция) */
TreeNode *insertHelper(TreeNode *node, int val) {
if (node == NULL) {
return newTreeNode(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 insert(AVLTree *tree, int val) {
tree->root = insertHelper(tree->root, val);
}
/* Рекурсивное удаление узла (вспомогательная функция) */
TreeNode *removeHelper(TreeNode *node, int val) {
TreeNode *child, *grandChild;
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) {
child = node->left;
if (node->right != NULL) {
child = node->right;
}
// Число дочерних узлов = 0, удалить node и сразу вернуть
if (child == NULL) {
return NULL;
} else {
// Число дочерних узлов = 1, удалить node напрямую
node = child;
}
} else {
// Число дочерних узлов = 2, удалить следующий по симметричному обходу узел и заменить им текущий узел
TreeNode *temp = node->right;
while (temp->left != NULL) {
temp = temp->left;
}
int tempVal = temp->val;
node->right = removeHelper(node->right, temp->val);
node->val = tempVal;
}
}
// Обновить высоту узла
updateHeight(node);
/* 2. Выполнить вращение, чтобы снова сбалансировать поддерево */
node = rotate(node);
// Вернуть корневой узел поддерева
return node;
}
/* Удаление узла */
// Из-за подключения stdio.h здесь нельзя использовать ключевое слово remove
void removeItem(AVLTree *tree, int val) {
TreeNode *root = removeHelper(tree->root, val);
}
/* Поиск узла */
TreeNode *search(AVLTree *tree, int val) {
TreeNode *cur = tree->root;
// Искать в цикле и выйти после прохода за листовой узел
while (cur != NULL) {
if (cur->val < val) {
// Целевой узел находится в правом поддереве cur
cur = cur->right;
} else if (cur->val > val) {
// Целевой узел находится в левом поддереве cur
cur = cur->left;
} else {
// Найти целевой узел и выйти из цикла
break;
}
}
// Найти целевой узел и выйти из цикла
return cur;
}
void testInsert(AVLTree *tree, int val) {
insert(tree, val);
printf("\nПосле вставки узла %d AVL-дерево имеет вид \n", val);
printTree(tree->root);
}
void testRemove(AVLTree *tree, int val) {
removeItem(tree, val);
printf("\nПосле удаления узла %d AVL-дерево имеет вид \n", val);
printTree(tree->root);
}
/* Driver Code */
int main() {
/* Инициализация пустого AVL-дерева */
AVLTree *tree = (AVLTree *)newAVLTree();
/* Вставка узла */
// Обратите внимание, как AVL-дерево сохраняет баланс после вставки узла
testInsert(tree, 1);
testInsert(tree, 2);
testInsert(tree, 3);
testInsert(tree, 4);
testInsert(tree, 5);
testInsert(tree, 8);
testInsert(tree, 7);
testInsert(tree, 9);
testInsert(tree, 10);
testInsert(tree, 6);
/* Вставка повторяющегося узла */
testInsert(tree, 7);
/* Удаление узла */
// Обратите внимание, как AVL-дерево сохраняет баланс после удаления узла
testRemove(tree, 8); // Удаление узла степени 0
testRemove(tree, 5); // Удаление узла степени 1
testRemove(tree, 4); // Удаление узла степени 2
/* Поиск узла */
TreeNode *node = search(tree, 7);
printf("\nНайденный объект узла, значение узла = %d \n", node->val);
// Освободить память
delAVLTree(tree);
return 0;
}
@@ -0,0 +1,171 @@
/**
* File: binary_search_tree.c
* Created Time: 2023-01-11
* Author: Reanon (793584285@qq.com)
*/
#include "../utils/common.h"
/* Структура двоичного дерева поиска */
typedef struct {
TreeNode *root;
} BinarySearchTree;
/* Конструктор */
BinarySearchTree *newBinarySearchTree() {
// Инициализировать пустое дерево
BinarySearchTree *bst = (BinarySearchTree *)malloc(sizeof(BinarySearchTree));
bst->root = NULL;
return bst;
}
/* Деструктор */
void delBinarySearchTree(BinarySearchTree *bst) {
freeMemoryTree(bst->root);
free(bst);
}
/* Получить корневой узел двоичного дерева */
TreeNode *getRoot(BinarySearchTree *bst) {
return bst->root;
}
/* Поиск узла */
TreeNode *search(BinarySearchTree *bst, int num) {
TreeNode *cur = bst->root;
// Искать в цикле и выйти после прохода за листовой узел
while (cur != NULL) {
if (cur->val < num) {
// Целевой узел находится в правом поддереве cur
cur = cur->right;
} else if (cur->val > num) {
// Целевой узел находится в левом поддереве cur
cur = cur->left;
} else {
// Найти целевой узел и выйти из цикла
break;
}
}
// Вернуть целевой узел
return cur;
}
/* Вставка узла */
void insert(BinarySearchTree *bst, int num) {
// Если дерево пусто, инициализировать корневой узел
if (bst->root == NULL) {
bst->root = newTreeNode(num);
return;
}
TreeNode *cur = bst->root, *pre = NULL;
// Искать в цикле и выйти после прохода за листовой узел
while (cur != NULL) {
// Найти повторяющийся узел и сразу вернуть
if (cur->val == num) {
return;
}
pre = cur;
if (cur->val < num) {
// Позиция вставки находится в правом поддереве cur
cur = cur->right;
} else {
// Позиция вставки находится в левом поддереве cur
cur = cur->left;
}
}
// Вставка узла
TreeNode *node = newTreeNode(num);
if (pre->val < num) {
pre->right = node;
} else {
pre->left = node;
}
}
/* Удаление узла */
// Из-за подключения stdio.h здесь нельзя использовать ключевое слово remove
void removeItem(BinarySearchTree *bst, int num) {
// Если дерево пусто, сразу вернуть
if (bst->root == NULL)
return;
TreeNode *cur = bst->root, *pre = NULL;
// Искать в цикле и выйти после прохода за листовой узел
while (cur != NULL) {
// Найти узел для удаления и выйти из цикла
if (cur->val == num)
break;
pre = cur;
if (cur->val < num) {
// Удаляемый узел находится в правом поддереве root
cur = cur->right;
} else {
// Удаляемый узел находится в левом поддереве root
cur = cur->left;
}
}
// Если узел для удаления отсутствует, сразу вернуть
if (cur == NULL)
return;
// Проверить, есть ли дочерние узлы у удаляемого узла
if (cur->left == NULL || cur->right == NULL) {
/* Число дочерних узлов = 0 или 1 */
// Когда число дочерних узлов = 0 / 1, child = nullptr / этот дочерний узел
TreeNode *child = cur->left != NULL ? cur->left : cur->right;
// Удалить узел cur
if (pre->left == cur) {
pre->left = child;
} else {
pre->right = child;
}
// Освободить память
free(cur);
} else {
/* Число дочерних узлов = 2 */
// Получить следующий узел после cur в симметричном обходе
TreeNode *tmp = cur->right;
while (tmp->left != NULL) {
tmp = tmp->left;
}
int tmpVal = tmp->val;
// Рекурсивно удалить узел tmp
removeItem(bst, tmp->val);
// Перезаписать cur значением tmp
cur->val = tmpVal;
}
}
/* Driver Code */
int main() {
/* Инициализация двоичного дерева поиска */
int nums[] = {8, 4, 12, 2, 6, 10, 14, 1, 3, 5, 7, 9, 11, 13, 15};
BinarySearchTree *bst = newBinarySearchTree();
for (int i = 0; i < sizeof(nums) / sizeof(int); i++) {
insert(bst, nums[i]);
}
printf("Инициализированное двоичное дерево\n");
printTree(getRoot(bst));
/* Поиск узла */
TreeNode *node = search(bst, 7);
printf("Значение найденного объекта узла = %d\n", node->val);
/* Вставка узла */
insert(bst, 16);
printf("После вставки узла 16 двоичное дерево имеет вид\n");
printTree(getRoot(bst));
/* Удаление узла */
removeItem(bst, 1);
printf("После удаления узла 1 двоичное дерево имеет вид\n");
printTree(getRoot(bst));
removeItem(bst, 2);
printf("После удаления узла 2 двоичное дерево имеет вид\n");
printTree(getRoot(bst));
removeItem(bst, 4);
printf("После удаления узла 4 двоичное дерево имеет вид\n");
printTree(getRoot(bst));
// Освободить память
delBinarySearchTree(bst);
return 0;
}
+43
View File
@@ -0,0 +1,43 @@
/**
* File: binary_tree.c
* Created Time: 2023-01-11
* Author: Reanon (793584285@qq.com)
*/
#include "../utils/common.h"
/* Driver Code */
int main() {
/* Инициализация двоичного дерева */
// Инициализация узла
TreeNode *n1 = newTreeNode(1);
TreeNode *n2 = newTreeNode(2);
TreeNode *n3 = newTreeNode(3);
TreeNode *n4 = newTreeNode(4);
TreeNode *n5 = newTreeNode(5);
// Построить связи между узлами (указатели)
n1->left = n2;
n1->right = n3;
n2->left = n4;
n2->right = n5;
printf("Инициализация двоичного дерева\n");
printTree(n1);
/* Вставка и удаление узлов */
TreeNode *P = newTreeNode(0);
// Вставить узел P между n1 -> n2
n1->left = P;
P->left = n2;
printf("После вставки узла P\n");
printTree(n1);
// Удалить узел P
n1->left = n2;
// Освободить память
free(P);
printf("После удаления узла P\n");
printTree(n1);
freeMemoryTree(n1);
return 0;
}
+73
View File
@@ -0,0 +1,73 @@
/**
* File: binary_tree_bfs.c
* Created Time: 2023-01-11
* Author: Reanon (793584285@qq.com)
*/
#include "../utils/common.h"
#define MAX_SIZE 100
/* Обход в ширину */
int *levelOrder(TreeNode *root, int *size) {
/* Вспомогательная очередь */
int front, rear;
int index, *arr;
TreeNode *node;
TreeNode **queue;
/* Вспомогательная очередь */
queue = (TreeNode **)malloc(sizeof(TreeNode *) * MAX_SIZE);
// Указатель очереди
front = 0, rear = 0;
// Добавить корневой узел
queue[rear++] = root;
// Инициализировать список для хранения последовательности обхода
/* Вспомогательный массив */
arr = (int *)malloc(sizeof(int) * MAX_SIZE);
// Указатель на массив
index = 0;
while (front < rear) {
// Извлечение из очереди
node = queue[front++];
// Сохранить значение узла
arr[index++] = node->val;
if (node->left != NULL) {
// Поместить левый дочерний узел в очередь
queue[rear++] = node->left;
}
if (node->right != NULL) {
// Поместить правый дочерний узел в очередь
queue[rear++] = node->right;
}
}
// Обновить значение длины массива
*size = index;
arr = realloc(arr, sizeof(int) * (*size));
// Освободить память вспомогательного массива
free(queue);
return arr;
}
/* Driver Code */
int main() {
/* Инициализация двоичного дерева */
// Здесь используется функция, напрямую строящая двоичное дерево из массива
int nums[] = {1, 2, 3, 4, 5, 6, 7};
int size = sizeof(nums) / sizeof(int);
TreeNode *root = arrayToTree(nums, size);
printf("Инициализация двоичного дерева\n");
printTree(root);
/* Обход в ширину */
// Нужно передать длину массива
int *arr = levelOrder(root, &size);
printf("Последовательность узлов при обходе по уровням = ");
printArray(arr, size);
// Освободить память
freeMemoryTree(root);
free(arr);
return 0;
}
+75
View File
@@ -0,0 +1,75 @@
/**
* File: binary_tree_dfs.c
* Created Time: 2023-01-11
* Author: Reanon (793584285@qq.com)
*/
#include "../utils/common.h"
#define MAX_SIZE 100
// Вспомогательный массив для хранения последовательности обхода
int arr[MAX_SIZE];
/* Предварительный обход */
void preOrder(TreeNode *root, int *size) {
if (root == NULL)
return;
// Порядок обхода: корень -> левое поддерево -> правое поддерево
arr[(*size)++] = root->val;
preOrder(root->left, size);
preOrder(root->right, size);
}
/* Симметричный обход */
void inOrder(TreeNode *root, int *size) {
if (root == NULL)
return;
// Порядок обхода: левое поддерево -> корень -> правое поддерево
inOrder(root->left, size);
arr[(*size)++] = root->val;
inOrder(root->right, size);
}
/* Обратный обход */
void postOrder(TreeNode *root, int *size) {
if (root == NULL)
return;
// Порядок обхода: левое поддерево -> правое поддерево -> корень
postOrder(root->left, size);
postOrder(root->right, size);
arr[(*size)++] = root->val;
}
/* Driver Code */
int main() {
/* Инициализация двоичного дерева */
// Здесь используется функция, напрямую строящая двоичное дерево из массива
int nums[] = {1, 2, 3, 4, 5, 6, 7};
int size = sizeof(nums) / sizeof(int);
TreeNode *root = arrayToTree(nums, size);
printf("Инициализация двоичного дерева\n");
printTree(root);
/* Предварительный обход */
// Инициализация вспомогательного массива
size = 0;
preOrder(root, &size);
printf("Последовательность узлов при предварительном обходе = ");
printArray(arr, size);
/* Симметричный обход */
size = 0;
inOrder(root, &size);
printf("Последовательность узлов при симметричном обходе = ");
printArray(arr, size);
/* Обратный обход */
size = 0;
postOrder(root, &size);
printf("Последовательность узлов при обратном обходе = ");
printArray(arr, size);
freeMemoryTree(root);
return 0;
}