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,151 @@
/**
* File: array_deque.java
* Created Time: 2023-02-16
* Author: krahets (krahets@163.com), FangYuan33 (374072213@qq.com)
*/
package chapter_stack_and_queue;
import java.util.*;
/* Двусторонняя очередь на основе кольцевого массива */
class ArrayDeque {
private int[] nums; // Массив для хранения элементов двусторонней очереди
private int front; // Указатель head, указывающий на первый элемент очереди
private int queSize; // Длина двусторонней очереди
/* Конструктор */
public ArrayDeque(int capacity) {
this.nums = new int[capacity];
front = queSize = 0;
}
/* Получить вместимость двусторонней очереди */
public int capacity() {
return nums.length;
}
/* Получение длины двусторонней очереди */
public int size() {
return queSize;
}
/* Проверка, пуста ли двусторонняя очередь */
public boolean isEmpty() {
return queSize == 0;
}
/* Вычислить индекс в кольцевом массиве */
private int index(int i) {
// С помощью операции взятия по модулю соединить начало и конец массива
// Когда i выходит за конец массива, он возвращается в начало
// Когда i выходит за начало массива, он возвращается в конец
return (i + capacity()) % capacity();
}
/* Добавление в голову очереди */
public void pushFirst(int num) {
if (queSize == capacity()) {
System.out.println("Двусторонняя очередь заполнена");
return;
}
// Указатель головы сдвигается на одну позицию влево
// С помощью операции взятия по модулю front после выхода за начало массива возвращается в хвост
front = index(front - 1);
// Добавить num в голову очереди
nums[front] = num;
queSize++;
}
/* Добавление в хвост очереди */
public void pushLast(int num) {
if (queSize == capacity()) {
System.out.println("Двусторонняя очередь заполнена");
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 IndexOutOfBoundsException();
return nums[front];
}
/* Доступ к элементу в конце очереди */
public int peekLast() {
if (isEmpty())
throw new IndexOutOfBoundsException();
// Вычислить индекс хвостового элемента
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 {
public static void main(String[] args) {
/* Инициализация двусторонней очереди */
ArrayDeque deque = new ArrayDeque(10);
deque.pushLast(3);
deque.pushLast(2);
deque.pushLast(5);
System.out.println("Двусторонняя очередь deque = " + Arrays.toString(deque.toArray()));
/* Доступ к элементу */
int peekFirst = deque.peekFirst();
System.out.println("Первый элемент peekFirst = " + peekFirst);
int peekLast = deque.peekLast();
System.out.println("Последний элемент peekLast = " + peekLast);
/* Добавление элемента в очередь */
deque.pushLast(4);
System.out.println("После добавления элемента 4 в хвост deque = " + Arrays.toString(deque.toArray()));
deque.pushFirst(1);
System.out.println("После добавления элемента 1 в голову deque = " + Arrays.toString(deque.toArray()));
/* Извлечение элемента из очереди */
int popLast = deque.popLast();
System.out.println("Извлеченный из хвоста элемент = " + popLast + ", deque после извлечения из хвоста = " + Arrays.toString(deque.toArray()));
int popFirst = deque.popFirst();
System.out.println("Извлеченный из головы элемент = " + popFirst + ", deque после извлечения из головы = " + Arrays.toString(deque.toArray()));
/* Получение длины двусторонней очереди */
int size = deque.size();
System.out.println("Длина двусторонней очереди size = " + size);
/* Проверка, пуста ли двусторонняя очередь */
boolean isEmpty = deque.isEmpty();
System.out.println("Пуста ли двусторонняя очередь = " + isEmpty);
}
}

View File

@@ -0,0 +1,115 @@
/**
* File: array_queue.java
* Created Time: 2022-11-25
* Author: krahets (krahets@163.com)
*/
package chapter_stack_and_queue;
import java.util.*;
/* Очередь на основе кольцевого массива */
class ArrayQueue {
private int[] nums; // Массив для хранения элементов очереди
private int front; // Указатель head, указывающий на первый элемент очереди
private int queSize; // Длина очереди
public ArrayQueue(int capacity) {
nums = new int[capacity];
front = queSize = 0;
}
/* Получить вместимость очереди */
public int capacity() {
return nums.length;
}
/* Получение длины очереди */
public int size() {
return queSize;
}
/* Проверка, пуста ли очередь */
public boolean isEmpty() {
return queSize == 0;
}
/* Поместить в очередь */
public void push(int num) {
if (queSize == capacity()) {
System.out.println("Очередь заполнена");
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 IndexOutOfBoundsException();
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 % capacity()];
}
return res;
}
}
public class array_queue {
public static void main(String[] args) {
/* Инициализация очереди */
int capacity = 10;
ArrayQueue queue = new ArrayQueue(capacity);
/* Добавление элемента в очередь */
queue.push(1);
queue.push(3);
queue.push(2);
queue.push(5);
queue.push(4);
System.out.println("Очередь queue = " + Arrays.toString(queue.toArray()));
/* Доступ к элементу в начале очереди */
int peek = queue.peek();
System.out.println("Первый элемент peek = " + peek);
/* Извлечение элемента из очереди */
int pop = queue.pop();
System.out.println("Извлеченный элемент pop = " + pop + ", queue после извлечения = " + Arrays.toString(queue.toArray()));
/* Получение длины очереди */
int size = queue.size();
System.out.println("Длина очереди size = " + size);
/* Проверка, пуста ли очередь */
boolean isEmpty = queue.isEmpty();
System.out.println("Пуста ли очередь = " + isEmpty);
/* Проверка кольцевого массива */
for (int i = 0; i < 10; i++) {
queue.push(i);
queue.pop();
System.out.println("После " + i + "-го раунда операций enqueue и dequeue queue = " + Arrays.toString(queue.toArray()));
}
}
}

View File

@@ -0,0 +1,84 @@
/**
* File: array_stack.java
* Created Time: 2022-11-25
* Author: krahets (krahets@163.com)
*/
package chapter_stack_and_queue;
import java.util.*;
/* Стек на основе массива */
class ArrayStack {
private ArrayList<Integer> stack;
public ArrayStack() {
// Инициализация списка (динамического массива)
stack = new ArrayList<>();
}
/* Получение длины стека */
public int size() {
return stack.size();
}
/* Проверка, пуст ли стек */
public boolean isEmpty() {
return size() == 0;
}
/* Поместить в стек */
public void push(int num) {
stack.add(num);
}
/* Извлечь из стека */
public int pop() {
if (isEmpty())
throw new IndexOutOfBoundsException();
return stack.remove(size() - 1);
}
/* Доступ к верхнему элементу стека */
public int peek() {
if (isEmpty())
throw new IndexOutOfBoundsException();
return stack.get(size() - 1);
}
/* Преобразовать List в Array и вернуть */
public Object[] toArray() {
return stack.toArray();
}
}
public class array_stack {
public static void main(String[] args) {
/* Инициализация стека */
ArrayStack stack = new ArrayStack();
/* Помещение элемента в стек */
stack.push(1);
stack.push(3);
stack.push(2);
stack.push(5);
stack.push(4);
System.out.println("Стек stack = " + Arrays.toString(stack.toArray()));
/* Доступ к верхнему элементу стека */
int peek = stack.peek();
System.out.println("Верхний элемент peek = " + peek);
/* Извлечение элемента из стека */
int pop = stack.pop();
System.out.println("Извлеченный элемент pop = " + pop + ", stack после извлечения = " + Arrays.toString(stack.toArray()));
/* Получение длины стека */
int size = stack.size();
System.out.println("Длина стека size = " + size);
/* Проверка на пустоту */
boolean isEmpty = stack.isEmpty();
System.out.println("Пуст ли стек = " + isEmpty);
}
}

View File

@@ -0,0 +1,46 @@
/**
* File: deque.java
* Created Time: 2022-11-25
* Author: krahets (krahets@163.com)
*/
package chapter_stack_and_queue;
import java.util.*;
public class deque {
public static void main(String[] args) {
/* Инициализация двусторонней очереди */
Deque<Integer> deque = new LinkedList<>();
deque.offerLast(3);
deque.offerLast(2);
deque.offerLast(5);
System.out.println("Двусторонняя очередь deque = " + deque);
/* Доступ к элементу */
int peekFirst = deque.peekFirst();
System.out.println("Первый элемент peekFirst = " + peekFirst);
int peekLast = deque.peekLast();
System.out.println("Последний элемент peekLast = " + peekLast);
/* Добавление элемента в очередь */
deque.offerLast(4);
System.out.println("После добавления элемента 4 в хвост deque = " + deque);
deque.offerFirst(1);
System.out.println("После добавления элемента 1 в голову deque = " + deque);
/* Извлечение элемента из очереди */
int popLast = deque.pollLast();
System.out.println("Извлеченный из хвоста элемент = " + popLast + ", deque после извлечения из хвоста = " + deque);
int popFirst = deque.pollFirst();
System.out.println("Извлеченный из головы элемент = " + popFirst + ", deque после извлечения из головы = " + deque);
/* Получение длины двусторонней очереди */
int size = deque.size();
System.out.println("Длина двусторонней очереди size = " + size);
/* Проверка, пуста ли двусторонняя очередь */
boolean isEmpty = deque.isEmpty();
System.out.println("Пуста ли двусторонняя очередь = " + isEmpty);
}
}

View File

@@ -0,0 +1,175 @@
/**
* File: linkedlist_deque.java
* Created Time: 2023-01-20
* Author: krahets (krahets@163.com)
*/
package chapter_stack_and_queue;
import java.util.*;
/* Узел двусвязного списка */
class ListNode {
int val; // Значение узла
ListNode next; // Ссылка на узел-преемник
ListNode prev; // Ссылка на узел-предшественник
ListNode(int val) {
this.val = val;
prev = next = null;
}
}
/* Двусторонняя очередь на основе двусвязного списка */
class LinkedListDeque {
private ListNode front, rear; // Головной узел front, хвостовой узел rear
private int queSize = 0; // Длина двусторонней очереди
public LinkedListDeque() {
front = rear = null;
}
/* Получение длины двусторонней очереди */
public int size() {
return queSize;
}
/* Проверка, пуста ли двусторонняя очередь */
public boolean isEmpty() {
return size() == 0;
}
/* Операция добавления в очередь */
private void push(int num, boolean isFront) {
ListNode node = new ListNode(num);
// Если связный список пуст, сделать так, чтобы и front, и rear указывали на node
if (isEmpty())
front = 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);
}
/* Операция извлечения из очереди */
private int pop(boolean isFront) {
if (isEmpty())
throw new IndexOutOfBoundsException();
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 IndexOutOfBoundsException();
return front.val;
}
/* Доступ к элементу в конце очереди */
public int peekLast() {
if (isEmpty())
throw new IndexOutOfBoundsException();
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 {
public static void main(String[] args) {
/* Инициализация двусторонней очереди */
LinkedListDeque deque = new LinkedListDeque();
deque.pushLast(3);
deque.pushLast(2);
deque.pushLast(5);
System.out.println("Двусторонняя очередь deque = " + Arrays.toString(deque.toArray()));
/* Доступ к элементу */
int peekFirst = deque.peekFirst();
System.out.println("Первый элемент peekFirst = " + peekFirst);
int peekLast = deque.peekLast();
System.out.println("Последний элемент peekLast = " + peekLast);
/* Добавление элемента в очередь */
deque.pushLast(4);
System.out.println("После добавления элемента 4 в хвост deque = " + Arrays.toString(deque.toArray()));
deque.pushFirst(1);
System.out.println("После добавления элемента 1 в голову deque = " + Arrays.toString(deque.toArray()));
/* Извлечение элемента из очереди */
int popLast = deque.popLast();
System.out.println("Извлеченный из хвоста элемент = " + popLast + ", deque после извлечения из хвоста = " + Arrays.toString(deque.toArray()));
int popFirst = deque.popFirst();
System.out.println("Извлеченный из головы элемент = " + popFirst + ", deque после извлечения из головы = " + Arrays.toString(deque.toArray()));
/* Получение длины двусторонней очереди */
int size = deque.size();
System.out.println("Длина двусторонней очереди size = " + size);
/* Проверка, пуста ли двусторонняя очередь */
boolean isEmpty = deque.isEmpty();
System.out.println("Пуста ли двусторонняя очередь = " + isEmpty);
}
}

View File

@@ -0,0 +1,104 @@
/**
* File: linkedlist_queue.java
* Created Time: 2022-11-25
* Author: krahets (krahets@163.com)
*/
package chapter_stack_and_queue;
import java.util.*;
/* Очередь на основе связного списка */
class LinkedListQueue {
private ListNode front, rear; // Головной узел front, хвостовой узел rear
private int queSize = 0;
public LinkedListQueue() {
front = null;
rear = null;
}
/* Получение длины очереди */
public int size() {
return queSize;
}
/* Проверка, пуста ли очередь */
public boolean isEmpty() {
return size() == 0;
}
/* Поместить в очередь */
public void push(int num) {
// Добавить num после хвостового узла
ListNode node = new ListNode(num);
// Если очередь пуста, сделать так, чтобы и head, и tail указывали на этот узел
if (front == null) {
front = node;
rear = node;
// Если очередь не пуста, добавить этот узел после хвостового узла
} else {
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 IndexOutOfBoundsException();
return front.val;
}
/* Преобразовать связный список в Array и вернуть */
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_queue {
public static void main(String[] args) {
/* Инициализация очереди */
LinkedListQueue queue = new LinkedListQueue();
/* Добавление элемента в очередь */
queue.push(1);
queue.push(3);
queue.push(2);
queue.push(5);
queue.push(4);
System.out.println("Очередь queue = " + Arrays.toString(queue.toArray()));
/* Доступ к элементу в начале очереди */
int peek = queue.peek();
System.out.println("Первый элемент peek = " + peek);
/* Извлечение элемента из очереди */
int pop = queue.pop();
System.out.println("Извлеченный элемент pop = " + pop + ", queue после извлечения = " + Arrays.toString(queue.toArray()));
/* Получение длины очереди */
int size = queue.size();
System.out.println("Длина очереди size = " + size);
/* Проверка, пуста ли очередь */
boolean isEmpty = queue.isEmpty();
System.out.println("Пуста ли очередь = " + isEmpty);
}
}

View File

@@ -0,0 +1,95 @@
/**
* File: linkedlist_stack.java
* Created Time: 2022-11-25
* Author: krahets (krahets@163.com)
*/
package chapter_stack_and_queue;
import java.util.*;
import utils.*;
/* Стек на основе связного списка */
class LinkedListStack {
private ListNode stackPeek; // Использовать головной узел как вершину стека
private int stkSize = 0; // Длина стека
public LinkedListStack() {
stackPeek = null;
}
/* Получение длины стека */
public int size() {
return stkSize;
}
/* Проверка, пуст ли стек */
public boolean isEmpty() {
return size() == 0;
}
/* Поместить в стек */
public void push(int num) {
ListNode node = new ListNode(num);
node.next = stackPeek;
stackPeek = node;
stkSize++;
}
/* Извлечь из стека */
public int pop() {
int num = peek();
stackPeek = stackPeek.next;
stkSize--;
return num;
}
/* Доступ к верхнему элементу стека */
public int peek() {
if (isEmpty())
throw new IndexOutOfBoundsException();
return stackPeek.val;
}
/* Преобразовать List в Array и вернуть */
public int[] toArray() {
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 {
public static void main(String[] args) {
/* Инициализация стека */
LinkedListStack stack = new LinkedListStack();
/* Помещение элемента в стек */
stack.push(1);
stack.push(3);
stack.push(2);
stack.push(5);
stack.push(4);
System.out.println("Стек stack = " + Arrays.toString(stack.toArray()));
/* Доступ к верхнему элементу стека */
int peek = stack.peek();
System.out.println("Верхний элемент peek = " + peek);
/* Извлечение элемента из стека */
int pop = stack.pop();
System.out.println("Извлеченный элемент pop = " + pop + ", stack после извлечения = " + Arrays.toString(stack.toArray()));
/* Получение длины стека */
int size = stack.size();
System.out.println("Длина стека size = " + size);
/* Проверка на пустоту */
boolean isEmpty = stack.isEmpty();
System.out.println("Пуст ли стек = " + isEmpty);
}
}

View File

@@ -0,0 +1,40 @@
/**
* File: queue.java
* Created Time: 2022-11-25
* Author: krahets (krahets@163.com)
*/
package chapter_stack_and_queue;
import java.util.*;
public class queue {
public static void main(String[] args) {
/* Инициализация очереди */
Queue<Integer> queue = new LinkedList<>();
/* Добавление элемента в очередь */
queue.offer(1);
queue.offer(3);
queue.offer(2);
queue.offer(5);
queue.offer(4);
System.out.println("Очередь queue = " + queue);
/* Доступ к элементу в начале очереди */
int peek = queue.peek();
System.out.println("Первый элемент peek = " + peek);
/* Извлечение элемента из очереди */
int pop = queue.poll();
System.out.println("Извлеченный элемент pop = " + pop + ", queue после извлечения = " + queue);
/* Получение длины очереди */
int size = queue.size();
System.out.println("Длина очереди size = " + size);
/* Проверка, пуста ли очередь */
boolean isEmpty = queue.isEmpty();
System.out.println("Пуста ли очередь = " + isEmpty);
}
}

View File

@@ -0,0 +1,40 @@
/**
* File: stack.java
* Created Time: 2022-11-25
* Author: krahets (krahets@163.com)
*/
package chapter_stack_and_queue;
import java.util.*;
public class stack {
public static void main(String[] args) {
/* Инициализация стека */
Stack<Integer> stack = new Stack<>();
/* Помещение элемента в стек */
stack.push(1);
stack.push(3);
stack.push(2);
stack.push(5);
stack.push(4);
System.out.println("Стек stack = " + stack);
/* Доступ к верхнему элементу стека */
int peek = stack.peek();
System.out.println("Верхний элемент peek = " + peek);
/* Извлечение элемента из стека */
int pop = stack.pop();
System.out.println("Извлеченный элемент pop = " + pop + ", stack после извлечения = " + stack);
/* Получение длины стека */
int size = stack.size();
System.out.println("Длина стека size = " + size);
/* Проверка на пустоту */
boolean isEmpty = stack.isEmpty();
System.out.println("Пуст ли стек = " + isEmpty);
}
}