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,76 @@
/**
* File: n_queens.cs
* Created Time: 2023-05-04
* Author: hpstory (hpstory1024@163.com)
*/
namespace hello_algo.chapter_backtracking;
public class n_queens {
/* Алгоритм бэктрекинга: n ферзей */
void Backtrack(int row, int n, List<List<string>> state, List<List<List<string>>> res,
bool[] cols, bool[] diags1, bool[] diags2) {
// Когда все строки уже обработаны, записать решение
if (row == n) {
List<List<string>> copyState = [];
foreach (List<string> sRow in state) {
copyState.Add(new List<string>(sRow));
}
res.Add(copyState);
return;
}
// Обойти все столбцы
for (int col = 0; col < n; col++) {
// Вычислить главную и побочную диагонали, соответствующие этой клетке
int diag1 = row - col + n - 1;
int diag2 = row + col;
// Отсечение: в столбце, главной диагонали и побочной диагонали этой клетки не должно быть ферзей
if (!cols[col] && !diags1[diag1] && !diags2[diag2]) {
// Попытка: поставить ферзя в эту клетку
state[row][col] = "Q";
cols[col] = diags1[diag1] = diags2[diag2] = true;
// Перейти к размещению следующей строки
Backtrack(row + 1, n, state, res, cols, diags1, diags2);
// Откат: восстановить эту клетку как пустую
state[row][col] = "#";
cols[col] = diags1[diag1] = diags2[diag2] = false;
}
}
}
/* Решить задачу о n ферзях */
List<List<List<string>>> NQueens(int n) {
// Инициализировать доску размера n*n, где 'Q' обозначает ферзя, а '#' — пустую клетку
List<List<string>> state = [];
for (int i = 0; i < n; i++) {
List<string> row = [];
for (int j = 0; j < n; j++) {
row.Add("#");
}
state.Add(row);
}
bool[] cols = new bool[n]; // Отмечать, есть ли ферзь в столбце
bool[] diags1 = new bool[2 * n - 1]; // Отмечать наличие ферзя на главной диагонали
bool[] diags2 = new bool[2 * n - 1]; // Отмечать наличие ферзя на побочной диагонали
List<List<List<string>>> res = [];
Backtrack(0, n, state, res, cols, diags1, diags2);
return res;
}
[Test]
public void Test() {
int n = 4;
List<List<List<string>>> res = NQueens(n);
Console.WriteLine("Размер входной доски = " + n);
Console.WriteLine("Количество способов расстановки ферзей: " + res.Count);
foreach (List<List<string>> state in res) {
Console.WriteLine("--------------------");
foreach (List<string> row in state) {
PrintUtil.PrintList(row);
}
}
}
}
@@ -0,0 +1,53 @@
/**
* File: permutations_i.cs
* Created Time: 2023-04-24
* Author: hpstory (hpstory1024@163.com)
*/
namespace hello_algo.chapter_backtracking;
public class permutations_i {
/* Алгоритм бэктрекинга: все перестановки I */
void Backtrack(List<int> state, int[] choices, bool[] selected, List<List<int>> res) {
// Когда длина состояния равна числу элементов, записать решение
if (state.Count == choices.Length) {
res.Add(new List<int>(state));
return;
}
// Перебор всех вариантов выбора
for (int i = 0; i < choices.Length; i++) {
int choice = choices[i];
// Отсечение: нельзя выбирать один и тот же элемент повторно
if (!selected[i]) {
// Попытка: сделать выбор и обновить состояние
selected[i] = true;
state.Add(choice);
// Перейти к следующему выбору
Backtrack(state, choices, selected, res);
// Откат: отменить выбор и восстановить предыдущее состояние
selected[i] = false;
state.RemoveAt(state.Count - 1);
}
}
}
/* Все перестановки I */
List<List<int>> PermutationsI(int[] nums) {
List<List<int>> res = [];
Backtrack([], nums, new bool[nums.Length], res);
return res;
}
[Test]
public void Test() {
int[] nums = [1, 2, 3];
List<List<int>> res = PermutationsI(nums);
Console.WriteLine("Входной массив nums = " + string.Join(", ", nums));
Console.WriteLine("Все перестановки res = ");
foreach (List<int> permutation in res) {
PrintUtil.PrintList(permutation);
}
}
}
@@ -0,0 +1,55 @@
/**
* File: permutations_ii.cs
* Created Time: 2023-04-24
* Author: hpstory (hpstory1024@163.com)
*/
namespace hello_algo.chapter_backtracking;
public class permutations_ii {
/* Алгоритм бэктрекинга: все перестановки II */
void Backtrack(List<int> state, int[] choices, bool[] selected, List<List<int>> res) {
// Когда длина состояния равна числу элементов, записать решение
if (state.Count == choices.Length) {
res.Add(new List<int>(state));
return;
}
// Перебор всех вариантов выбора
HashSet<int> duplicated = [];
for (int i = 0; i < choices.Length; i++) {
int choice = choices[i];
// Отсечение: нельзя выбирать один и тот же элемент повторно и нельзя повторно выбирать равные элементы
if (!selected[i] && !duplicated.Contains(choice)) {
// Попытка: сделать выбор и обновить состояние
duplicated.Add(choice); // Записать значения уже выбранных элементов
selected[i] = true;
state.Add(choice);
// Перейти к следующему выбору
Backtrack(state, choices, selected, res);
// Откат: отменить выбор и восстановить предыдущее состояние
selected[i] = false;
state.RemoveAt(state.Count - 1);
}
}
}
/* Все перестановки II */
List<List<int>> PermutationsII(int[] nums) {
List<List<int>> res = [];
Backtrack([], nums, new bool[nums.Length], res);
return res;
}
[Test]
public void Test() {
int[] nums = [1, 2, 2];
List<List<int>> res = PermutationsII(nums);
Console.WriteLine("Входной массив nums = " + string.Join(", ", nums));
Console.WriteLine("Все перестановки res = ");
foreach (List<int> permutation in res) {
PrintUtil.PrintList(permutation);
}
}
}
@@ -0,0 +1,37 @@
/**
* File: preorder_traversal_i_compact.cs
* Created Time: 2023-04-17
* Author: hpstory (hpstory1024@163.com)
*/
namespace hello_algo.chapter_backtracking;
public class preorder_traversal_i_compact {
List<TreeNode> res = [];
/* Предварительный обход: пример 1 */
void PreOrder(TreeNode? root) {
if (root == null) {
return;
}
if (root.val == 7) {
// Записать решение
res.Add(root);
}
PreOrder(root.left);
PreOrder(root.right);
}
[Test]
public void Test() {
TreeNode? root = TreeNode.ListToTree([1, 7, 3, 4, 5, 6, 7]);
Console.WriteLine("\nИнициализация двоичного дерева");
PrintUtil.PrintTree(root);
// Предварительный обход
PreOrder(root);
Console.WriteLine("\nВсе узлы со значением 7");
PrintUtil.PrintList(res.Select(p => p.val).ToList());
}
}
@@ -0,0 +1,44 @@
/**
* File: preorder_traversal_ii_compact.cs
* Created Time: 2023-04-17
* Author: hpstory (hpstory1024@163.com)
*/
namespace hello_algo.chapter_backtracking;
public class preorder_traversal_ii_compact {
List<TreeNode> path = [];
List<List<TreeNode>> res = [];
/* Предварительный обход: пример 2 */
void PreOrder(TreeNode? root) {
if (root == null) {
return;
}
// Попытка
path.Add(root);
if (root.val == 7) {
// Записать решение
res.Add(new List<TreeNode>(path));
}
PreOrder(root.left);
PreOrder(root.right);
// Откат
path.RemoveAt(path.Count - 1);
}
[Test]
public void Test() {
TreeNode? root = TreeNode.ListToTree([1, 7, 3, 4, 5, 6, 7]);
Console.WriteLine("\nИнициализация двоичного дерева");
PrintUtil.PrintTree(root);
// Предварительный обход
PreOrder(root);
Console.WriteLine("\nВсе пути от корня к узлу 7");
foreach (List<TreeNode> path in res) {
PrintUtil.PrintList(path.Select(p => p.val).ToList());
}
}
}
@@ -0,0 +1,45 @@
/**
* File: preorder_traversal_iii_compact.cs
* Created Time: 2023-04-17
* Author: hpstory (hpstory1024@163.com)
*/
namespace hello_algo.chapter_backtracking;
public class preorder_traversal_iii_compact {
List<TreeNode> path = [];
List<List<TreeNode>> res = [];
/* Предварительный обход: пример 3 */
void PreOrder(TreeNode? root) {
// Отсечение
if (root == null || root.val == 3) {
return;
}
// Попытка
path.Add(root);
if (root.val == 7) {
// Записать решение
res.Add(new List<TreeNode>(path));
}
PreOrder(root.left);
PreOrder(root.right);
// Откат
path.RemoveAt(path.Count - 1);
}
[Test]
public void Test() {
TreeNode? root = TreeNode.ListToTree([1, 7, 3, 4, 5, 6, 7]);
Console.WriteLine("\nИнициализация двоичного дерева");
PrintUtil.PrintTree(root);
// Предварительный обход
PreOrder(root);
Console.WriteLine("\nВсе пути от корня к узлу 7, не содержащие узлов со значением 3");
foreach (List<TreeNode> path in res) {
PrintUtil.PrintList(path.Select(p => p.val).ToList());
}
}
}
@@ -0,0 +1,72 @@
/**
* File: preorder_traversal_iii_template.cs
* Created Time: 2023-04-17
* Author: hpstory (hpstory1024@163.com)
*/
namespace hello_algo.chapter_backtracking;
public class preorder_traversal_iii_template {
/* Проверить, является ли текущее состояние решением */
bool IsSolution(List<TreeNode> state) {
return state.Count != 0 && state[^1].val == 7;
}
/* Записать решение */
void RecordSolution(List<TreeNode> state, List<List<TreeNode>> res) {
res.Add(new List<TreeNode>(state));
}
/* Проверить, допустим ли этот выбор в текущем состоянии */
bool IsValid(List<TreeNode> state, TreeNode choice) {
return choice != null && choice.val != 3;
}
/* Обновить состояние */
void MakeChoice(List<TreeNode> state, TreeNode choice) {
state.Add(choice);
}
/* Восстановить состояние */
void UndoChoice(List<TreeNode> state, TreeNode choice) {
state.RemoveAt(state.Count - 1);
}
/* Алгоритм бэктрекинга: пример 3 */
void Backtrack(List<TreeNode> state, List<TreeNode> choices, List<List<TreeNode>> res) {
// Проверить, является ли текущее состояние решением
if (IsSolution(state)) {
// Записать решение
RecordSolution(state, res);
}
// Перебор всех вариантов выбора
foreach (TreeNode choice in choices) {
// Отсечение: проверить допустимость выбора
if (IsValid(state, choice)) {
// Попытка: сделать выбор и обновить состояние
MakeChoice(state, choice);
// Перейти к следующему выбору
Backtrack(state, [choice.left!, choice.right!], res);
// Откат: отменить выбор и восстановить предыдущее состояние
UndoChoice(state, choice);
}
}
}
[Test]
public void Test() {
TreeNode? root = TreeNode.ListToTree([1, 7, 3, 4, 5, 6, 7]);
Console.WriteLine("\nИнициализация двоичного дерева");
PrintUtil.PrintTree(root);
// Алгоритм бэктрекинга
List<List<TreeNode>> res = [];
List<TreeNode> choices = [root!];
Backtrack([], choices, res);
Console.WriteLine("\nВсе пути от корня к узлу 7, в которых путь не содержит узлов со значением 3");
foreach (List<TreeNode> path in res) {
PrintUtil.PrintList(path.Select(p => p.val).ToList());
}
}
}
@@ -0,0 +1,55 @@
/**
* File: subset_sum_i.cs
* Created Time: 2023-06-25
* Author: hpstory (hpstory1024@163.com)
*/
namespace hello_algo.chapter_backtracking;
public class subset_sum_i {
/* Алгоритм бэктрекинга: сумма подмножеств I */
void Backtrack(List<int> state, int target, int[] choices, int start, List<List<int>> res) {
// Если сумма подмножества равна target, записать решение
if (target == 0) {
res.Add(new List<int>(state));
return;
}
// Обойти все варианты выбора
// Отсечение 2: начинать обход с start, чтобы избежать генерации повторяющихся подмножеств
for (int i = start; i < choices.Length; i++) {
// Отсечение 1: если сумма подмножества превышает target, немедленно завершить цикл
// Это связано с тем, что массив уже отсортирован, следующие элементы больше, и сумма подмножества точно превысит target
if (target - choices[i] < 0) {
break;
}
// Попытка: сделать выбор и обновить target и start
state.Add(choices[i]);
// Перейти к следующему выбору
Backtrack(state, target - choices[i], choices, i, res);
// Откат: отменить выбор и восстановить предыдущее состояние
state.RemoveAt(state.Count - 1);
}
}
/* Решить задачу суммы подмножеств I */
List<List<int>> SubsetSumI(int[] nums, int target) {
List<int> state = []; // Состояние (подмножество)
Array.Sort(nums); // Отсортировать nums
int start = 0; // Стартовая вершина обхода
List<List<int>> res = []; // Список результатов (список подмножеств)
Backtrack(state, target, nums, start, res);
return res;
}
[Test]
public void Test() {
int[] nums = [3, 4, 5];
int target = 9;
List<List<int>> res = SubsetSumI(nums, target);
Console.WriteLine("Входной массив nums = " + string.Join(", ", nums) + ", target = " + target);
Console.WriteLine("Все подмножества с суммой " + target + ": res = ");
foreach (var subset in res) {
PrintUtil.PrintList(subset);
}
}
}
@@ -0,0 +1,53 @@
/**
* File: subset_sum_i_naive.cs
* Created Time: 2023-06-25
* Author: hpstory (hpstory1024@163.com)
*/
namespace hello_algo.chapter_backtracking;
public class subset_sum_i_naive {
/* Алгоритм бэктрекинга: сумма подмножеств I */
void Backtrack(List<int> state, int target, int total, int[] choices, List<List<int>> res) {
// Если сумма подмножества равна target, записать решение
if (total == target) {
res.Add(new List<int>(state));
return;
}
// Перебор всех вариантов выбора
for (int i = 0; i < choices.Length; i++) {
// Отсечение: если сумма подмножества превышает target, пропустить этот выбор
if (total + choices[i] > target) {
continue;
}
// Попытка: сделать выбор и обновить элемент и total
state.Add(choices[i]);
// Перейти к следующему выбору
Backtrack(state, target, total + choices[i], choices, res);
// Откат: отменить выбор и восстановить предыдущее состояние
state.RemoveAt(state.Count - 1);
}
}
/* Решить задачу суммы подмножеств I (с повторяющимися подмножествами) */
List<List<int>> SubsetSumINaive(int[] nums, int target) {
List<int> state = []; // Состояние (подмножество)
int total = 0; // Сумма подмножеств
List<List<int>> res = []; // Список результатов (список подмножеств)
Backtrack(state, target, total, nums, res);
return res;
}
[Test]
public void Test() {
int[] nums = [3, 4, 5];
int target = 9;
List<List<int>> res = SubsetSumINaive(nums, target);
Console.WriteLine("Входной массив nums = " + string.Join(", ", nums) + ", target = " + target);
Console.WriteLine("Все подмножества с суммой " + target + ": res = ");
foreach (var subset in res) {
PrintUtil.PrintList(subset);
}
Console.WriteLine("Обратите внимание: результат этого метода содержит повторяющиеся множества");
}
}
@@ -0,0 +1,60 @@
/**
* File: subset_sum_ii.cs
* Created Time: 2023-06-25
* Author: hpstory (hpstory1024@163.com)
*/
namespace hello_algo.chapter_backtracking;
public class subset_sum_ii {
/* Алгоритм бэктрекинга: сумма подмножеств II */
void Backtrack(List<int> state, int target, int[] choices, int start, List<List<int>> res) {
// Если сумма подмножества равна target, записать решение
if (target == 0) {
res.Add(new List<int>(state));
return;
}
// Обойти все варианты выбора
// Отсечение 2: начинать обход с start, чтобы избежать генерации повторяющихся подмножеств
// Отсечение 3: начинать обход с start, чтобы избежать повторного выбора одного и того же элемента
for (int i = start; i < choices.Length; i++) {
// Отсечение 1: если сумма подмножества превышает target, немедленно завершить цикл
// Это связано с тем, что массив уже отсортирован, следующие элементы больше, и сумма подмножества точно превысит target
if (target - choices[i] < 0) {
break;
}
// Отсечение 4: если этот элемент равен элементу слева, значит ветвь поиска повторяется, ее нужно сразу пропустить
if (i > start && choices[i] == choices[i - 1]) {
continue;
}
// Попытка: сделать выбор и обновить target и start
state.Add(choices[i]);
// Перейти к следующему выбору
Backtrack(state, target - choices[i], choices, i + 1, res);
// Откат: отменить выбор и восстановить предыдущее состояние
state.RemoveAt(state.Count - 1);
}
}
/* Решить задачу суммы подмножеств II */
List<List<int>> SubsetSumII(int[] nums, int target) {
List<int> state = []; // Состояние (подмножество)
Array.Sort(nums); // Отсортировать nums
int start = 0; // Стартовая вершина обхода
List<List<int>> res = []; // Список результатов (список подмножеств)
Backtrack(state, target, nums, start, res);
return res;
}
[Test]
public void Test() {
int[] nums = [4, 4, 5];
int target = 9;
List<List<int>> res = SubsetSumII(nums, target);
Console.WriteLine("Входной массив nums = " + string.Join(", ", nums) + ", target = " + target);
Console.WriteLine("Все подмножества с суммой " + target + ": res = ");
foreach (var subset in res) {
PrintUtil.PrintList(subset);
}
}
}