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
+64
View File
@@ -0,0 +1,64 @@
/**
* File: heap.cs
* Created Time: 2023-02-06
* Author: zjkung1123 (zjkung1123@gmail.com)
*/
namespace hello_algo.chapter_heap;
public class heap {
void TestPush(PriorityQueue<int, int> heap, int val) {
heap.Enqueue(val, val); // Добавление элемента в кучу
Console.WriteLine($"\nПосле добавления элемента {val} в кучу\n");
PrintUtil.PrintHeap(heap);
}
void TestPop(PriorityQueue<int, int> heap) {
int val = heap.Dequeue(); // Извлечение элемента с вершины кучи
Console.WriteLine($"\nПосле извлечения элемента вершины кучи {val}\n");
PrintUtil.PrintHeap(heap);
}
[Test]
public void Test() {
/* Инициализация кучи */
// Инициализация минимальной кучи
PriorityQueue<int, int> minHeap = new();
// Инициализировать максимальную кучу (достаточно изменить Comparer с помощью lambda-выражения)
PriorityQueue<int, int> maxHeap = new(Comparer<int>.Create((x, y) => y.CompareTo(x)));
Console.WriteLine("Ниже приведен тестовый пример для max-heap");
/* Добавление элемента в кучу */
TestPush(maxHeap, 1);
TestPush(maxHeap, 3);
TestPush(maxHeap, 2);
TestPush(maxHeap, 5);
TestPush(maxHeap, 4);
/* Получение элемента с вершины кучи */
int peek = maxHeap.Peek();
Console.WriteLine($"Элемент на вершине кучи = {peek}");
/* Извлечение элемента с вершины кучи */
// Элементы, извлеченные из кучи, образуют последовательность от большего к меньшему
TestPop(maxHeap);
TestPop(maxHeap);
TestPop(maxHeap);
TestPop(maxHeap);
TestPop(maxHeap);
/* Получение размера кучи */
int size = maxHeap.Count;
Console.WriteLine($"Количество элементов в куче = {size}");
/* Проверка, пуста ли куча */
bool isEmpty = maxHeap.Count == 0;
Console.WriteLine($"Пуста ли куча: {isEmpty}");
/* Построить кучу по входному списку */
var list = new int[] { 1, 3, 2, 5, 4 };
minHeap = new PriorityQueue<int, int>(list.Select(x => (x, x)));
Console.WriteLine("После построения min-heap из входного списка");
PrintUtil.PrintHeap(minHeap);
}
}
+160
View File
@@ -0,0 +1,160 @@
/**
* File: my_heap.cs
* Created Time: 2023-02-06
* Author: zjkung1123 (zjkung1123@gmail.com)
*/
namespace hello_algo.chapter_heap;
/* Максимальная куча */
class MaxHeap {
// Использовать список вместо массива, чтобы не учитывать проблему расширения
List<int> maxHeap;
/* Конструктор, создающий пустую кучу */
public MaxHeap() {
maxHeap = [];
}
/* Конструктор: построить кучу по входному списку */
public MaxHeap(IEnumerable<int> nums) {
// Добавить элементы списка в кучу без изменений
maxHeap = new List<int>(nums);
// Выполнить heapify для всех узлов, кроме листовых
var size = Parent(this.Size() - 1);
for (int i = size; i >= 0; i--) {
SiftDown(i);
}
}
/* Получить индекс левого дочернего узла */
int Left(int i) {
return 2 * i + 1;
}
/* Получить индекс правого дочернего узла */
int Right(int i) {
return 2 * i + 2;
}
/* Получить индекс родительского узла */
int Parent(int i) {
return (i - 1) / 2; // Округление вниз при делении
}
/* Доступ к элементу на вершине кучи */
public int Peek() {
return maxHeap[0];
}
/* Добавление элемента в кучу */
public void Push(int val) {
// Добавление узла
maxHeap.Add(val);
// Просеивание снизу вверх
SiftUp(Size() - 1);
}
/* Получение размера кучи */
public int Size() {
return maxHeap.Count;
}
/* Проверка, пуста ли куча */
public bool IsEmpty() {
return Size() == 0;
}
/* Начиная с узла i, выполнить просеивание снизу вверх */
void SiftUp(int i) {
while (true) {
// Получение родительского узла для узла i
int p = Parent(i);
// Если «выход за пределы корневого узла» или «узел не требует исправления», завершить просеивание
if (p < 0 || maxHeap[i] <= maxHeap[p])
break;
// Поменять два узла местами
Swap(i, p);
// Циклическое просеивание вверх
i = p;
}
}
/* Извлечение элемента из кучи */
public int Pop() {
// Обработка пустого случая
if (IsEmpty())
throw new IndexOutOfRangeException();
// Поменять корневой узел с самым правым листом местами (поменять первый и последний элементы)
Swap(0, Size() - 1);
// Удаление узла
int val = maxHeap.Last();
maxHeap.RemoveAt(Size() - 1);
// Просеивание сверху вниз
SiftDown(0);
// Вернуть элемент с вершины кучи
return val;
}
/* Начиная с узла i, выполнить просеивание сверху вниз */
void SiftDown(int i) {
while (true) {
// Определить узел с максимальным значением среди i, l и r и обозначить его как ma
int l = Left(i), r = Right(i), ma = i;
if (l < Size() && maxHeap[l] > maxHeap[ma])
ma = l;
if (r < Size() && maxHeap[r] > maxHeap[ma])
ma = r;
// Если «узел i максимален» или «выход за пределы листовых узлов», завершить просеивание
if (ma == i) break;
// Поменять два узла местами
Swap(i, ma);
// Циклическое просеивание вниз
i = ma;
}
}
/* Поменять элементы местами */
void Swap(int i, int p) {
(maxHeap[i], maxHeap[p]) = (maxHeap[p], maxHeap[i]);
}
/* Вывести кучу (двоичное дерево) */
public void Print() {
var queue = new Queue<int>(maxHeap);
PrintUtil.PrintHeap(queue);
}
}
public class my_heap {
[Test]
public void Test() {
/* Инициализация максимальной кучи */
MaxHeap maxHeap = new([9, 8, 6, 6, 7, 5, 2, 1, 4, 3, 6, 2]);
Console.WriteLine("\nПосле построения кучи из входного списка");
maxHeap.Print();
/* Получение элемента с вершины кучи */
int peek = maxHeap.Peek();
Console.WriteLine($"Элемент на вершине кучи = {peek}");
/* Добавление элемента в кучу */
int val = 7;
maxHeap.Push(val);
Console.WriteLine($"После добавления элемента {val} в кучу");
maxHeap.Print();
/* Извлечение элемента с вершины кучи */
peek = maxHeap.Pop();
Console.WriteLine($"После извлечения элемента вершины кучи {peek}");
maxHeap.Print();
/* Получение размера кучи */
int size = maxHeap.Size();
Console.WriteLine($"Количество элементов в куче = {size}");
/* Проверка, пуста ли куча */
bool isEmpty = maxHeap.IsEmpty();
Console.WriteLine($"Пуста ли куча: {isEmpty}");
}
}
+37
View File
@@ -0,0 +1,37 @@
/**
* File: top_k.cs
* Created Time: 2023-06-14
* Author: hpstory (hpstory1024@163.com)
*/
namespace hello_algo.chapter_heap;
public class top_k {
/* Найти k наибольших элементов массива с помощью кучи */
PriorityQueue<int, int> TopKHeap(int[] nums, int k) {
// Инициализация минимальной кучи
PriorityQueue<int, int> heap = new();
// Поместить первые k элементов массива в кучу
for (int i = 0; i < k; i++) {
heap.Enqueue(nums[i], nums[i]);
}
// Начиная с элемента k+1, поддерживать длину кучи равной k
for (int i = k; i < nums.Length; i++) {
// Если текущий элемент больше элемента на вершине кучи, извлечь вершину кучи и добавить текущий элемент в кучу
if (nums[i] > heap.Peek()) {
heap.Dequeue();
heap.Enqueue(nums[i], nums[i]);
}
}
return heap;
}
[Test]
public void Test() {
int[] nums = [1, 7, 6, 3, 2];
int k = 3;
PriorityQueue<int, int> res = TopKHeap(nums, k);
Console.WriteLine("Наибольшие " + k + " элементов =");
PrintUtil.PrintHeap(res);
}
}