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

View File

@@ -0,0 +1,152 @@
/**
* File: array_deque.cs
* Created Time: 2023-03-08
* Author: hpstory (hpstory1024@163.com)
*/
namespace hello_algo.chapter_stack_and_queue;
/* Двусторонняя очередь на основе кольцевого массива */
public class ArrayDeque {
int[] nums; // Массив для хранения элементов двусторонней очереди
int front; // Указатель head, указывающий на первый элемент очереди
int queSize; // Длина двусторонней очереди
/* Конструктор */
public ArrayDeque(int capacity) {
nums = new int[capacity];
front = queSize = 0;
}
/* Получить вместимость двусторонней очереди */
int Capacity() {
return nums.Length;
}
/* Получение длины двусторонней очереди */
public int Size() {
return queSize;
}
/* Проверка, пуста ли двусторонняя очередь */
public bool IsEmpty() {
return queSize == 0;
}
/* Вычислить индекс в кольцевом массиве */
int Index(int i) {
// С помощью операции взятия по модулю соединить начало и конец массива
// Когда i выходит за конец массива, он возвращается в начало
// Когда i выходит за начало массива, он возвращается в конец
return (i + Capacity()) % Capacity();
}
/* Добавление в голову очереди */
public void PushFirst(int num) {
if (queSize == Capacity()) {
Console.WriteLine("Двусторонняя очередь заполнена");
return;
}
// Указатель головы сдвигается на одну позицию влево
// С помощью операции взятия по модулю front после выхода за начало массива возвращается в хвост
front = Index(front - 1);
// Добавить num в голову очереди
nums[front] = num;
queSize++;
}
/* Добавление в хвост очереди */
public void PushLast(int num) {
if (queSize == Capacity()) {
Console.WriteLine("Двусторонняя очередь заполнена");
return;
}
// Вычислить указатель хвоста, указывающий на индекс хвоста + 1
int rear = Index(front + queSize);
// Добавить num в хвост очереди
nums[rear] = num;
queSize++;
}
/* Извлечение из головы очереди */
public int PopFirst() {
int num = PeekFirst();
// Указатель головы сдвигается на одну позицию назад
front = Index(front + 1);
queSize--;
return num;
}
/* Извлечение из хвоста очереди */
public int PopLast() {
int num = PeekLast();
queSize--;
return num;
}
/* Доступ к элементу в начале очереди */
public int PeekFirst() {
if (IsEmpty()) {
throw new InvalidOperationException();
}
return nums[front];
}
/* Доступ к элементу в конце очереди */
public int PeekLast() {
if (IsEmpty()) {
throw new InvalidOperationException();
}
// Вычислить индекс хвостового элемента
int last = Index(front + queSize - 1);
return nums[last];
}
/* Вернуть массив для вывода */
public int[] ToArray() {
// Преобразовывать только элементы списка в пределах фактической длины
int[] res = new int[queSize];
for (int i = 0, j = front; i < queSize; i++, j++) {
res[i] = nums[Index(j)];
}
return res;
}
}
public class array_deque {
[Test]
public void Test() {
/* Инициализация двусторонней очереди */
ArrayDeque deque = new(10);
deque.PushLast(3);
deque.PushLast(2);
deque.PushLast(5);
Console.WriteLine("Двусторонняя очередь deque = " + string.Join(" ", deque.ToArray()));
/* Доступ к элементу */
int peekFirst = deque.PeekFirst();
Console.WriteLine("Первый элемент peekFirst = " + peekFirst);
int peekLast = deque.PeekLast();
Console.WriteLine("Последний элемент peekLast = " + peekLast);
/* Добавление элемента в очередь */
deque.PushLast(4);
Console.WriteLine("После добавления элемента 4 в хвост deque = " + string.Join(" ", deque.ToArray()));
deque.PushFirst(1);
Console.WriteLine("После добавления элемента 1 в голову deque = " + string.Join(" ", deque.ToArray()));
/* Извлечение элемента из очереди */
int popLast = deque.PopLast();
Console.WriteLine("Извлеченный из хвоста элемент = " + popLast + ", deque после извлечения из хвоста = " + string.Join(" ", deque.ToArray()));
int popFirst = deque.PopFirst();
Console.WriteLine("Извлеченный из головы элемент = " + popFirst + ", deque после извлечения из головы = " + string.Join(" ", deque.ToArray()));
/* Получение длины двусторонней очереди */
int size = deque.Size();
Console.WriteLine("Длина двусторонней очереди size = " + size);
/* Проверка, пуста ли двусторонняя очередь */
bool isEmpty = deque.IsEmpty();
Console.WriteLine("Пуста ли двусторонняя очередь = " + isEmpty);
}
}

View File

@@ -0,0 +1,114 @@
/**
* File: array_queue.cs
* Created Time: 2022-12-23
* Author: haptear (haptear@hotmail.com)
*/
namespace hello_algo.chapter_stack_and_queue;
/* Очередь на основе кольцевого массива */
class ArrayQueue {
int[] nums; // Массив для хранения элементов очереди
int front; // Указатель head, указывающий на первый элемент очереди
int queSize; // Длина очереди
public ArrayQueue(int capacity) {
nums = new int[capacity];
front = queSize = 0;
}
/* Получить вместимость очереди */
int Capacity() {
return nums.Length;
}
/* Получение длины очереди */
public int Size() {
return queSize;
}
/* Проверка, пуста ли очередь */
public bool IsEmpty() {
return queSize == 0;
}
/* Поместить в очередь */
public void Push(int num) {
if (queSize == Capacity()) {
Console.WriteLine("Очередь заполнена");
return;
}
// Вычислить указатель хвоста, указывающий на индекс хвоста + 1
// С помощью операции взятия по модулю вернуть rear к началу после выхода за конец массива
int rear = (front + queSize) % Capacity();
// Добавить num в хвост очереди
nums[rear] = num;
queSize++;
}
/* Извлечь из очереди */
public int Pop() {
int num = Peek();
// Указатель head сдвигается на одну позицию назад; если он выходит за конец, то возвращается в начало массива
front = (front + 1) % Capacity();
queSize--;
return num;
}
/* Доступ к элементу в начале очереди */
public int Peek() {
if (IsEmpty())
throw new Exception();
return nums[front];
}
/* Вернуть массив */
public int[] ToArray() {
// Преобразовывать только элементы списка в пределах фактической длины
int[] res = new int[queSize];
for (int i = 0, j = front; i < queSize; i++, j++) {
res[i] = nums[j % this.Capacity()];
}
return res;
}
}
public class array_queue {
[Test]
public void Test() {
/* Инициализация очереди */
int capacity = 10;
ArrayQueue queue = new(capacity);
/* Добавление элемента в очередь */
queue.Push(1);
queue.Push(3);
queue.Push(2);
queue.Push(5);
queue.Push(4);
Console.WriteLine("Очередь queue = " + string.Join(",", queue.ToArray()));
/* Доступ к элементу в начале очереди */
int peek = queue.Peek();
Console.WriteLine("Первый элемент peek = " + peek);
/* Извлечение элемента из очереди */
int pop = queue.Pop();
Console.WriteLine("Извлеченный элемент pop = " + pop + ", queue после извлечения = " + string.Join(",", queue.ToArray()));
/* Получение длины очереди */
int size = queue.Size();
Console.WriteLine("Длина очереди size = " + size);
/* Проверка, пуста ли очередь */
bool isEmpty = queue.IsEmpty();
Console.WriteLine("Пуста ли очередь = " + isEmpty);
/* Проверка кольцевого массива */
for (int i = 0; i < 10; i++) {
queue.Push(i);
queue.Pop();
Console.WriteLine("После " + i + "-го раунда операций enqueue и dequeue queue = " + string.Join(",", queue.ToArray()));
}
}
}

View File

@@ -0,0 +1,84 @@
/**
* File: array_stack.cs
* Created Time: 2022-12-23
* Author: haptear (haptear@hotmail.com)
*/
namespace hello_algo.chapter_stack_and_queue;
/* Стек на основе массива */
class ArrayStack {
List<int> stack;
public ArrayStack() {
// Инициализация списка (динамического массива)
stack = [];
}
/* Получение длины стека */
public int Size() {
return stack.Count;
}
/* Проверка, пуст ли стек */
public bool IsEmpty() {
return Size() == 0;
}
/* Поместить в стек */
public void Push(int num) {
stack.Add(num);
}
/* Извлечь из стека */
public int Pop() {
if (IsEmpty())
throw new Exception();
var val = Peek();
stack.RemoveAt(Size() - 1);
return val;
}
/* Доступ к верхнему элементу стека */
public int Peek() {
if (IsEmpty())
throw new Exception();
return stack[Size() - 1];
}
/* Преобразовать List в Array и вернуть */
public int[] ToArray() {
return [.. stack];
}
}
public class array_stack {
[Test]
public void Test() {
/* Инициализация стека */
ArrayStack stack = new();
/* Помещение элемента в стек */
stack.Push(1);
stack.Push(3);
stack.Push(2);
stack.Push(5);
stack.Push(4);
Console.WriteLine("Стек stack = " + string.Join(",", stack.ToArray()));
/* Доступ к верхнему элементу стека */
int peek = stack.Peek();
Console.WriteLine("Верхний элемент peek = " + peek);
/* Извлечение элемента из стека */
int pop = stack.Pop();
Console.WriteLine("Извлеченный элемент pop = " + pop + ", stack после извлечения = " + string.Join(",", stack.ToArray()));
/* Получение длины стека */
int size = stack.Size();
Console.WriteLine("Длина стека size = " + size);
/* Проверка на пустоту */
bool isEmpty = stack.IsEmpty();
Console.WriteLine("Пуст ли стек = " + isEmpty);
}
}

View File

@@ -0,0 +1,44 @@
/**
* File: deque.cs
* Created Time: 2022-12-30
* Author: moonache (microin1301@outlook.com)
*/
namespace hello_algo.chapter_stack_and_queue;
public class deque {
[Test]
public void Test() {
/* Инициализация двусторонней очереди */
// В C# связный список LinkedList рассматривается как двусторонняя очередь
LinkedList<int> deque = new();
/* Добавление элемента в очередь */
deque.AddLast(2); // Добавить в хвост очереди
deque.AddLast(5);
deque.AddLast(4);
deque.AddFirst(3); // Добавить в голову очереди
deque.AddFirst(1);
Console.WriteLine("Двусторонняя очередь deque = " + string.Join(",", deque));
/* Доступ к элементу */
int? peekFirst = deque.First?.Value; // Элемент в голове очереди
Console.WriteLine("Первый элемент peekFirst = " + peekFirst);
int? peekLast = deque.Last?.Value; // Элемент в хвосте очереди
Console.WriteLine("Последний элемент peekLast = " + peekLast);
/* Извлечение элемента из очереди */
deque.RemoveFirst(); // Извлечь элемент из головы очереди
Console.WriteLine("После извлечения элемента из головы deque = " + string.Join(",", deque));
deque.RemoveLast(); // Извлечь элемент из хвоста очереди
Console.WriteLine("После извлечения элемента из хвоста deque = " + string.Join(",", deque));
/* Получение длины двусторонней очереди */
int size = deque.Count;
Console.WriteLine("Длина двусторонней очереди size = " + size);
/* Проверка, пуста ли двусторонняя очередь */
bool isEmpty = deque.Count == 0;
Console.WriteLine("Пуста ли двусторонняя очередь = " + isEmpty);
}
}

View File

@@ -0,0 +1,177 @@
/**
* File: linkedlist_deque.cs
* Created Time: 2023-03-08
* Author: hpstory (hpstory1024@163.com)
*/
namespace hello_algo.chapter_stack_and_queue;
/* Узел двусвязного списка */
public class ListNode(int val) {
public int val = val; // Значение узла
public ListNode? next = null; // Ссылка на узел-преемник
public ListNode? prev = null; // Ссылка на узел-предшественник
}
/* Двусторонняя очередь на основе двусвязного списка */
public class LinkedListDeque {
ListNode? front, rear; // Головной узел front, хвостовой узел rear
int queSize = 0; // Длина двусторонней очереди
public LinkedListDeque() {
front = null;
rear = null;
}
/* Получение длины двусторонней очереди */
public int Size() {
return queSize;
}
/* Проверка, пуста ли двусторонняя очередь */
public bool IsEmpty() {
return Size() == 0;
}
/* Операция добавления в очередь */
void Push(int num, bool isFront) {
ListNode node = new(num);
// Если связный список пуст, сделать так, чтобы и front, и rear указывали на node
if (IsEmpty()) {
front = node;
rear = node;
}
// Операция добавления в голову очереди
else if (isFront) {
// Добавить node в голову списка
front!.prev = node;
node.next = front;
front = node; // Обновить головной узел
}
// Операция добавления в хвост очереди
else {
// Добавить node в хвост списка
rear!.next = node;
node.prev = rear;
rear = node; // Обновить хвостовой узел
}
queSize++; // Обновить длину очереди
}
/* Добавление в голову очереди */
public void PushFirst(int num) {
Push(num, true);
}
/* Добавление в хвост очереди */
public void PushLast(int num) {
Push(num, false);
}
/* Операция извлечения из очереди */
int? Pop(bool isFront) {
if (IsEmpty())
throw new Exception();
int? val;
// Операция извлечения из головы очереди
if (isFront) {
val = front?.val; // Временно сохранить значение головного узла
// Удалить головной узел
ListNode? fNext = front?.next;
if (fNext != null) {
fNext.prev = null;
front!.next = null;
}
front = fNext; // Обновить головной узел
}
// Операция извлечения из хвоста очереди
else {
val = rear?.val; // Временно сохранить значение хвостового узла
// Удалить хвостовой узел
ListNode? rPrev = rear?.prev;
if (rPrev != null) {
rPrev.next = null;
rear!.prev = null;
}
rear = rPrev; // Обновить хвостовой узел
}
queSize--; // Обновить длину очереди
return val;
}
/* Извлечение из головы очереди */
public int? PopFirst() {
return Pop(true);
}
/* Извлечение из хвоста очереди */
public int? PopLast() {
return Pop(false);
}
/* Доступ к элементу в начале очереди */
public int? PeekFirst() {
if (IsEmpty())
throw new Exception();
return front?.val;
}
/* Доступ к элементу в конце очереди */
public int? PeekLast() {
if (IsEmpty())
throw new Exception();
return rear?.val;
}
/* Вернуть массив для вывода */
public int?[] ToArray() {
ListNode? node = front;
int?[] res = new int?[Size()];
for (int i = 0; i < res.Length; i++) {
res[i] = node?.val;
node = node?.next;
}
return res;
}
}
public class linkedlist_deque {
[Test]
public void Test() {
/* Инициализация двусторонней очереди */
LinkedListDeque deque = new();
deque.PushLast(3);
deque.PushLast(2);
deque.PushLast(5);
Console.WriteLine("Двусторонняя очередь deque = " + string.Join(" ", deque.ToArray()));
/* Доступ к элементу */
int? peekFirst = deque.PeekFirst();
Console.WriteLine("Первый элемент peekFirst = " + peekFirst);
int? peekLast = deque.PeekLast();
Console.WriteLine("Последний элемент peekLast = " + peekLast);
/* Добавление элемента в очередь */
deque.PushLast(4);
Console.WriteLine("После добавления элемента 4 в хвост deque = " + string.Join(" ", deque.ToArray()));
deque.PushFirst(1);
Console.WriteLine("После добавления элемента 1 в голову deque = " + string.Join(" ", deque.ToArray()));
/* Извлечение элемента из очереди */
int? popLast = deque.PopLast();
Console.WriteLine("Извлеченный из хвоста элемент = " + popLast + ", deque после извлечения из хвоста = " + string.Join(" ", deque.ToArray()));
int? popFirst = deque.PopFirst();
Console.WriteLine("Извлеченный из головы элемент = " + popFirst + ", deque после извлечения из головы = " + string.Join(" ", deque.ToArray()));
/* Получение длины двусторонней очереди */
int size = deque.Size();
Console.WriteLine("Длина двусторонней очереди size = " + size);
/* Проверка, пуста ли двусторонняя очередь */
bool isEmpty = deque.IsEmpty();
Console.WriteLine("Пуста ли двусторонняя очередь = " + isEmpty);
}
}

View File

@@ -0,0 +1,106 @@
/**
* File: linkedlist_queue.cs
* Created Time: 2022-12-23
* Author: haptear (haptear@hotmail.com)
*/
namespace hello_algo.chapter_stack_and_queue;
/* Очередь на основе связного списка */
class LinkedListQueue {
ListNode? front, rear; // Головной узел front, хвостовой узел rear
int queSize = 0;
public LinkedListQueue() {
front = null;
rear = null;
}
/* Получение длины очереди */
public int Size() {
return queSize;
}
/* Проверка, пуста ли очередь */
public bool IsEmpty() {
return Size() == 0;
}
/* Поместить в очередь */
public void Push(int num) {
// Добавить num после хвостового узла
ListNode node = new(num);
// Если очередь пуста, сделать так, чтобы и head, и tail указывали на этот узел
if (front == null) {
front = node;
rear = node;
// Если очередь не пуста, добавить этот узел после хвостового узла
} else if (rear != null) {
rear.next = node;
rear = node;
}
queSize++;
}
/* Извлечь из очереди */
public int Pop() {
int num = Peek();
// Удалить головной узел
front = front?.next;
queSize--;
return num;
}
/* Доступ к элементу в начале очереди */
public int Peek() {
if (IsEmpty())
throw new Exception();
return front!.val;
}
/* Преобразовать связный список в Array и вернуть */
public int[] ToArray() {
if (front == null)
return [];
ListNode? node = front;
int[] res = new int[Size()];
for (int i = 0; i < res.Length; i++) {
res[i] = node!.val;
node = node.next;
}
return res;
}
}
public class linkedlist_queue {
[Test]
public void Test() {
/* Инициализация очереди */
LinkedListQueue queue = new();
/* Добавление элемента в очередь */
queue.Push(1);
queue.Push(3);
queue.Push(2);
queue.Push(5);
queue.Push(4);
Console.WriteLine("Очередь queue = " + string.Join(",", queue.ToArray()));
/* Доступ к элементу в начале очереди */
int peek = queue.Peek();
Console.WriteLine("Первый элемент peek = " + peek);
/* Извлечение элемента из очереди */
int pop = queue.Pop();
Console.WriteLine("Извлеченный элемент pop = " + pop + ", queue после извлечения = " + string.Join(",", queue.ToArray()));
/* Получение длины очереди */
int size = queue.Size();
Console.WriteLine("Длина очереди size = " + size);
/* Проверка, пуста ли очередь */
bool isEmpty = queue.IsEmpty();
Console.WriteLine("Пуста ли очередь = " + isEmpty);
}
}

View File

@@ -0,0 +1,97 @@
/**
* File: linkedlist_stack.cs
* Created Time: 2022-12-23
* Author: haptear (haptear@hotmail.com)
*/
namespace hello_algo.chapter_stack_and_queue;
/* Стек на основе связного списка */
class LinkedListStack {
ListNode? stackPeek; // Использовать головной узел как вершину стека
int stkSize = 0; // Длина стека
public LinkedListStack() {
stackPeek = null;
}
/* Получение длины стека */
public int Size() {
return stkSize;
}
/* Проверка, пуст ли стек */
public bool IsEmpty() {
return Size() == 0;
}
/* Поместить в стек */
public void Push(int num) {
ListNode node = new(num) {
next = stackPeek
};
stackPeek = node;
stkSize++;
}
/* Извлечь из стека */
public int Pop() {
int num = Peek();
stackPeek = stackPeek!.next;
stkSize--;
return num;
}
/* Доступ к верхнему элементу стека */
public int Peek() {
if (IsEmpty())
throw new Exception();
return stackPeek!.val;
}
/* Преобразовать List в Array и вернуть */
public int[] ToArray() {
if (stackPeek == null)
return [];
ListNode? node = stackPeek;
int[] res = new int[Size()];
for (int i = res.Length - 1; i >= 0; i--) {
res[i] = node!.val;
node = node.next;
}
return res;
}
}
public class linkedlist_stack {
[Test]
public void Test() {
/* Инициализация стека */
LinkedListStack stack = new();
/* Помещение элемента в стек */
stack.Push(1);
stack.Push(3);
stack.Push(2);
stack.Push(5);
stack.Push(4);
Console.WriteLine("Стек stack = " + string.Join(",", stack.ToArray()));
/* Доступ к верхнему элементу стека */
int peek = stack.Peek();
Console.WriteLine("Верхний элемент peek = " + peek);
/* Извлечение элемента из стека */
int pop = stack.Pop();
Console.WriteLine("Извлеченный элемент pop = " + pop + ", stack после извлечения = " + string.Join(",", stack.ToArray()));
/* Получение длины стека */
int size = stack.Size();
Console.WriteLine("Длина стека size = " + size);
/* Проверка на пустоту */
bool isEmpty = stack.IsEmpty();
Console.WriteLine("Пуст ли стек = " + isEmpty);
}
}

View File

@@ -0,0 +1,39 @@
/**
* File: queue.cs
* Created Time: 2022-12-23
* Author: haptear (haptear@hotmail.com)
*/
namespace hello_algo.chapter_stack_and_queue;
public class queue {
[Test]
public void Test() {
/* Инициализация очереди */
Queue<int> queue = new();
/* Добавление элемента в очередь */
queue.Enqueue(1);
queue.Enqueue(3);
queue.Enqueue(2);
queue.Enqueue(5);
queue.Enqueue(4);
Console.WriteLine("Очередь queue = " + string.Join(",", queue));
/* Доступ к элементу в начале очереди */
int peek = queue.Peek();
Console.WriteLine("Первый элемент peek = " + peek);
/* Извлечение элемента из очереди */
int pop = queue.Dequeue();
Console.WriteLine("Извлеченный элемент pop = " + pop + ", queue после извлечения = " + string.Join(",", queue));
/* Получение длины очереди */
int size = queue.Count;
Console.WriteLine("Длина очереди size = " + size);
/* Проверка, пуста ли очередь */
bool isEmpty = queue.Count == 0;
Console.WriteLine("Пуста ли очередь = " + isEmpty);
}
}

View File

@@ -0,0 +1,40 @@
/**
* File: stack.cs
* Created Time: 2022-12-23
* Author: haptear (haptear@hotmail.com)
*/
namespace hello_algo.chapter_stack_and_queue;
public class stack {
[Test]
public void Test() {
/* Инициализация стека */
Stack<int> stack = new();
/* Помещение элемента в стек */
stack.Push(1);
stack.Push(3);
stack.Push(2);
stack.Push(5);
stack.Push(4);
// Обратите внимание: stack.ToArray() возвращает последовательность в обратном порядке, то есть индекс 0 соответствует вершине стека
Console.WriteLine("Стек stack = " + string.Join(",", stack));
/* Доступ к верхнему элементу стека */
int peek = stack.Peek();
Console.WriteLine("Верхний элемент peek = " + peek);
/* Извлечение элемента из стека */
int pop = stack.Pop();
Console.WriteLine("Извлеченный элемент pop = " + pop + ", stack после извлечения = " + string.Join(",", stack));
/* Получение длины стека */
int size = stack.Count;
Console.WriteLine("Длина стека size = " + size);
/* Проверка на пустоту */
bool isEmpty = stack.Count == 0;
Console.WriteLine("Пуст ли стек = " + isEmpty);
}
}