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,6 @@
add_executable(array_stack array_stack.c)
add_executable(linkedlist_stack linkedlist_stack.c)
add_executable(array_queue array_queue.c)
add_executable(linkedlist_queue linkedlist_queue.c)
add_executable(array_deque array_deque.c)
add_executable(linkedlist_deque linkedlist_deque.c)
@@ -0,0 +1,172 @@
/**
* File: array_deque.c
* Created Time: 2023-03-13
* Author: Gonglja (glj0@outlook.com)
*/
#include "../utils/common.h"
/* Двусторонняя очередь на основе кольцевого массива */
typedef struct {
int *nums; // Массив для хранения элементов очереди
int front; // Указатель head, указывающий на первый элемент очереди
int queSize; // Указатель хвоста, указывающий на позицию после хвоста
int queCapacity; // Вместимость очереди
} ArrayDeque;
/* Конструктор */
ArrayDeque *newArrayDeque(int capacity) {
ArrayDeque *deque = (ArrayDeque *)malloc(sizeof(ArrayDeque));
// Инициализация массива
deque->queCapacity = capacity;
deque->nums = (int *)malloc(sizeof(int) * deque->queCapacity);
deque->front = deque->queSize = 0;
return deque;
}
/* Деструктор */
void delArrayDeque(ArrayDeque *deque) {
free(deque->nums);
free(deque);
}
/* Получить вместимость двусторонней очереди */
int capacity(ArrayDeque *deque) {
return deque->queCapacity;
}
/* Получение длины двусторонней очереди */
int size(ArrayDeque *deque) {
return deque->queSize;
}
/* Проверка, пуста ли двусторонняя очередь */
bool empty(ArrayDeque *deque) {
return deque->queSize == 0;
}
/* Вычислить индекс в кольцевом массиве */
int dequeIndex(ArrayDeque *deque, int i) {
// С помощью операции взятия остатка соединить начало и конец массива
// Когда i выходит за хвост массива, вернуться к началу
// Когда i выходит за голову массива, вернуться к концу
return ((i + capacity(deque)) % capacity(deque));
}
/* Добавление в голову очереди */
void pushFirst(ArrayDeque *deque, int num) {
if (deque->queSize == capacity(deque)) {
printf("Дек заполнен\r\n");
return;
}
// Указатель головы сместить влево на одну позицию
// С помощью операции взятия остатка реализовать возврат front к хвосту после выхода за начало массива
deque->front = dequeIndex(deque, deque->front - 1);
// Добавить num в голову очереди
deque->nums[deque->front] = num;
deque->queSize++;
}
/* Добавление в хвост очереди */
void pushLast(ArrayDeque *deque, int num) {
if (deque->queSize == capacity(deque)) {
printf("Дек заполнен\r\n");
return;
}
// Вычислить указатель хвоста, указывающий на индекс хвоста + 1
int rear = dequeIndex(deque, deque->front + deque->queSize);
// Добавить num в хвост очереди
deque->nums[rear] = num;
deque->queSize++;
}
/* Доступ к элементу в начале очереди */
int peekFirst(ArrayDeque *deque) {
// Ошибка доступа: двусторонняя очередь пуста
assert(empty(deque) == 0);
return deque->nums[deque->front];
}
/* Доступ к элементу в конце очереди */
int peekLast(ArrayDeque *deque) {
// Ошибка доступа: двусторонняя очередь пуста
assert(empty(deque) == 0);
int last = dequeIndex(deque, deque->front + deque->queSize - 1);
return deque->nums[last];
}
/* Извлечение из головы очереди */
int popFirst(ArrayDeque *deque) {
int num = peekFirst(deque);
// Указатель головы сдвигается на одну позицию назад
deque->front = dequeIndex(deque, deque->front + 1);
deque->queSize--;
return num;
}
/* Извлечение из хвоста очереди */
int popLast(ArrayDeque *deque) {
int num = peekLast(deque);
deque->queSize--;
return num;
}
/* Вернуть массив для вывода */
int *toArray(ArrayDeque *deque, int *queSize) {
*queSize = deque->queSize;
int *res = (int *)calloc(deque->queSize, sizeof(int));
int j = deque->front;
for (int i = 0; i < deque->queSize; i++) {
res[i] = deque->nums[j % deque->queCapacity];
j++;
}
return res;
}
/* Driver Code */
int main() {
/* Инициализация очереди */
int capacity = 10;
int queSize;
ArrayDeque *deque = newArrayDeque(capacity);
pushLast(deque, 3);
pushLast(deque, 2);
pushLast(deque, 5);
printf("Дек deque = ");
printArray(toArray(deque, &queSize), queSize);
/* Доступ к элементу */
int peekFirstNum = peekFirst(deque);
printf("Элемент в голове peekFirst = %d\r\n", peekFirstNum);
int peekLastNum = peekLast(deque);
printf("Элемент в хвосте peekLast = %d\r\n", peekLastNum);
/* Добавление элемента в очередь */
pushLast(deque, 4);
printf("После вставки элемента 4 в хвост дек = ");
printArray(toArray(deque, &queSize), queSize);
pushFirst(deque, 1);
printf("После вставки элемента 1 в голову дек = ");
printArray(toArray(deque, &queSize), queSize);
/* Извлечение элемента из очереди */
int popLastNum = popLast(deque);
printf("Извлечен элемент из хвоста = %d, дек после извлечения из хвоста = ", popLastNum);
printArray(toArray(deque, &queSize), queSize);
int popFirstNum = popFirst(deque);
printf("Извлечен элемент из головы = %d, дек после извлечения из головы = ", popFirstNum);
printArray(toArray(deque, &queSize), queSize);
/* Получение длины очереди */
int dequeSize = size(deque);
printf("Длина дека size = %d\r\n", dequeSize);
/* Проверка, пуста ли очередь */
bool isEmpty = empty(deque);
printf("Пуста ли очередь = %s\r\n", isEmpty ? "true" : "false");
// Освободить память
delArrayDeque(deque);
return 0;
}
@@ -0,0 +1,134 @@
/**
* File: array_queue.c
* Created Time: 2023-01-28
* Author: Zero (glj0@outlook.com)
*/
#include "../utils/common.h"
/* Очередь на основе кольцевого массива */
typedef struct {
int *nums; // Массив для хранения элементов очереди
int front; // Указатель head, указывающий на первый элемент очереди
int queSize; // Указатель хвоста, указывающий на позицию после хвоста
int queCapacity; // Вместимость очереди
} ArrayQueue;
/* Конструктор */
ArrayQueue *newArrayQueue(int capacity) {
ArrayQueue *queue = (ArrayQueue *)malloc(sizeof(ArrayQueue));
// Инициализация массива
queue->queCapacity = capacity;
queue->nums = (int *)malloc(sizeof(int) * queue->queCapacity);
queue->front = queue->queSize = 0;
return queue;
}
/* Деструктор */
void delArrayQueue(ArrayQueue *queue) {
free(queue->nums);
free(queue);
}
/* Получить вместимость очереди */
int capacity(ArrayQueue *queue) {
return queue->queCapacity;
}
/* Получение длины очереди */
int size(ArrayQueue *queue) {
return queue->queSize;
}
/* Проверка, пуста ли очередь */
bool empty(ArrayQueue *queue) {
return queue->queSize == 0;
}
/* Доступ к элементу в начале очереди */
int peek(ArrayQueue *queue) {
assert(size(queue) != 0);
return queue->nums[queue->front];
}
/* Поместить в очередь */
void push(ArrayQueue *queue, int num) {
if (size(queue) == capacity(queue)) {
printf("Очередь заполнена\r\n");
return;
}
// Вычислить указатель хвоста, указывающий на индекс хвоста + 1
// С помощью операции взятия по модулю вернуть rear к началу после выхода за конец массива
int rear = (queue->front + queue->queSize) % queue->queCapacity;
// Добавить num в хвост очереди
queue->nums[rear] = num;
queue->queSize++;
}
/* Извлечь из очереди */
int pop(ArrayQueue *queue) {
int num = peek(queue);
// Указатель head сдвигается на одну позицию назад; если он выходит за конец, то возвращается в начало массива
queue->front = (queue->front + 1) % queue->queCapacity;
queue->queSize--;
return num;
}
/* Вернуть массив для вывода */
int *toArray(ArrayQueue *queue, int *queSize) {
*queSize = queue->queSize;
int *res = (int *)calloc(queue->queSize, sizeof(int));
int j = queue->front;
for (int i = 0; i < queue->queSize; i++) {
res[i] = queue->nums[j % queue->queCapacity];
j++;
}
return res;
}
/* Driver Code */
int main() {
/* Инициализация очереди */
int capacity = 10;
int queSize;
ArrayQueue *queue = newArrayQueue(capacity);
/* Добавление элемента в очередь */
push(queue, 1);
push(queue, 3);
push(queue, 2);
push(queue, 5);
push(queue, 4);
printf("Очередь queue = ");
printArray(toArray(queue, &queSize), queSize);
/* Доступ к элементу в начале очереди */
int peekNum = peek(queue);
printf("Элемент в голове peek = %d\r\n", peekNum);
/* Извлечение элемента из очереди */
peekNum = pop(queue);
printf("Извлечен элемент из очереди pop = %d, очередь после извлечения = ", peekNum);
printArray(toArray(queue, &queSize), queSize);
/* Получение длины очереди */
int queueSize = size(queue);
printf("Длина очереди size = %d\r\n", queueSize);
/* Проверка, пуста ли очередь */
bool isEmpty = empty(queue);
printf("Пуста ли очередь = %s\r\n", isEmpty ? "true" : "false");
/* Проверка кольцевого массива */
for (int i = 0; i < 10; i++) {
push(queue, i);
pop(queue);
printf("После %d-го цикла enqueue + dequeue queue = ", i);
printArray(toArray(queue, &queSize), queSize);
}
// Освободить память
delArrayQueue(queue);
return 0;
}
@@ -0,0 +1,103 @@
/**
* File: array_stack.c
* Created Time: 2023-01-12
* Author: Zero (glj0@outlook.com)
*/
#include "../utils/common.h"
#define MAX_SIZE 5000
/* Стек на основе массива */
typedef struct {
int *data;
int size;
} ArrayStack;
/* Конструктор */
ArrayStack *newArrayStack() {
ArrayStack *stack = malloc(sizeof(ArrayStack));
// Инициализировать большую вместимость, чтобы избежать расширения
stack->data = malloc(sizeof(int) * MAX_SIZE);
stack->size = 0;
return stack;
}
/* Деструктор */
void delArrayStack(ArrayStack *stack) {
free(stack->data);
free(stack);
}
/* Получение длины стека */
int size(ArrayStack *stack) {
return stack->size;
}
/* Проверка, пуст ли стек */
bool isEmpty(ArrayStack *stack) {
return stack->size == 0;
}
/* Поместить в стек */
void push(ArrayStack *stack, int num) {
if (stack->size == MAX_SIZE) {
printf("Стек заполнен\n");
return;
}
stack->data[stack->size] = num;
stack->size++;
}
/* Доступ к верхнему элементу стека */
int peek(ArrayStack *stack) {
if (stack->size == 0) {
printf("стек пуст\n");
return INT_MAX;
}
return stack->data[stack->size - 1];
}
/* Извлечь из стека */
int pop(ArrayStack *stack) {
int val = peek(stack);
stack->size--;
return val;
}
/* Driver Code */
int main() {
/* Инициализация стека */
ArrayStack *stack = newArrayStack();
/* Помещение элемента в стек */
push(stack, 1);
push(stack, 3);
push(stack, 2);
push(stack, 5);
push(stack, 4);
printf("Стек stack = ");
printArray(stack->data, stack->size);
/* Доступ к верхнему элементу стека */
int val = peek(stack);
printf("Верхний элемент стека top = %d\n", val);
/* Извлечение элемента из стека */
val = pop(stack);
printf("Извлечен элемент из стека pop = %d, стек после извлечения = ", val);
printArray(stack->data, stack->size);
/* Получение длины стека */
int size = stack->size;
printf("Длина стека size = %d\n", size);
/* Проверка на пустоту */
bool empty = isEmpty(stack);
printf("Пуст ли стек = %s\n", empty ? "true" : "false");
// Освободить память
delArrayStack(stack);
return 0;
}
@@ -0,0 +1,212 @@
/**
* File: linkedlist_deque.c
* Created Time: 2023-03-13
* Author: Gonglja (glj0@outlook.com)
*/
#include "../utils/common.h"
/* Узел двусвязного списка */
typedef struct DoublyListNode {
int val; // Значение узла
struct DoublyListNode *next; // Узел-преемник
struct DoublyListNode *prev; // Узел-предшественник
} DoublyListNode;
/* Конструктор */
DoublyListNode *newDoublyListNode(int num) {
DoublyListNode *new = (DoublyListNode *)malloc(sizeof(DoublyListNode));
new->val = num;
new->next = NULL;
new->prev = NULL;
return new;
}
/* Деструктор */
void delDoublyListNode(DoublyListNode *node) {
free(node);
}
/* Двусторонняя очередь на основе двусвязного списка */
typedef struct {
DoublyListNode *front, *rear; // Головной узел front, хвостовой узел rear
int queSize; // Длина двусторонней очереди
} LinkedListDeque;
/* Конструктор */
LinkedListDeque *newLinkedListDeque() {
LinkedListDeque *deque = (LinkedListDeque *)malloc(sizeof(LinkedListDeque));
deque->front = NULL;
deque->rear = NULL;
deque->queSize = 0;
return deque;
}
/* Деструктор */
void delLinkedListdeque(LinkedListDeque *deque) {
// Освободить все узлы
for (int i = 0; i < deque->queSize && deque->front != NULL; i++) {
DoublyListNode *tmp = deque->front;
deque->front = deque->front->next;
free(tmp);
}
// Освободить структуру deque
free(deque);
}
/* Получение длины очереди */
int size(LinkedListDeque *deque) {
return deque->queSize;
}
/* Проверка, пуста ли очередь */
bool empty(LinkedListDeque *deque) {
return (size(deque) == 0);
}
/* Поместить в очередь */
void push(LinkedListDeque *deque, int num, bool isFront) {
DoublyListNode *node = newDoublyListNode(num);
// Если связный список пуст, пусть front и rear оба указывают на node
if (empty(deque)) {
deque->front = deque->rear = node;
}
// Операция добавления в голову очереди
else if (isFront) {
// Добавить node в голову списка
deque->front->prev = node;
node->next = deque->front;
deque->front = node; // Обновить головной узел
}
// Операция добавления в хвост очереди
else {
// Добавить node в хвост списка
deque->rear->next = node;
node->prev = deque->rear;
deque->rear = node;
}
deque->queSize++; // Обновить длину очереди
}
/* Добавление в голову очереди */
void pushFirst(LinkedListDeque *deque, int num) {
push(deque, num, true);
}
/* Добавление в хвост очереди */
void pushLast(LinkedListDeque *deque, int num) {
push(deque, num, false);
}
/* Доступ к элементу в начале очереди */
int peekFirst(LinkedListDeque *deque) {
assert(size(deque) && deque->front);
return deque->front->val;
}
/* Доступ к элементу в конце очереди */
int peekLast(LinkedListDeque *deque) {
assert(size(deque) && deque->rear);
return deque->rear->val;
}
/* Извлечь из очереди */
int pop(LinkedListDeque *deque, bool isFront) {
if (empty(deque))
return -1;
int val;
// Операция извлечения из головы очереди
if (isFront) {
val = peekFirst(deque); // Временно сохранить значение головного узла
DoublyListNode *fNext = deque->front->next;
if (fNext) {
fNext->prev = NULL;
deque->front->next = NULL;
}
delDoublyListNode(deque->front);
deque->front = fNext; // Обновить головной узел
}
// Операция извлечения из хвоста очереди
else {
val = peekLast(deque); // Временно сохранить значение хвостового узла
DoublyListNode *rPrev = deque->rear->prev;
if (rPrev) {
rPrev->next = NULL;
deque->rear->prev = NULL;
}
delDoublyListNode(deque->rear);
deque->rear = rPrev; // Обновить хвостовой узел
}
deque->queSize--; // Обновить длину очереди
return val;
}
/* Извлечение из головы очереди */
int popFirst(LinkedListDeque *deque) {
return pop(deque, true);
}
/* Извлечение из хвоста очереди */
int popLast(LinkedListDeque *deque) {
return pop(deque, false);
}
/* Вывести очередь */
void printLinkedListDeque(LinkedListDeque *deque) {
int *arr = malloc(sizeof(int) * deque->queSize);
// Скопировать данные связного списка в массив
int i;
DoublyListNode *node;
for (i = 0, node = deque->front; i < deque->queSize; i++) {
arr[i] = node->val;
node = node->next;
}
printArray(arr, deque->queSize);
free(arr);
}
/* Driver Code */
int main() {
/* Инициализация двусторонней очереди */
LinkedListDeque *deque = newLinkedListDeque();
pushLast(deque, 3);
pushLast(deque, 2);
pushLast(deque, 5);
printf("Дек deque = ");
printLinkedListDeque(deque);
/* Доступ к элементу */
int peekFirstNum = peekFirst(deque);
printf("Элемент в голове peekFirst = %d\r\n", peekFirstNum);
int peekLastNum = peekLast(deque);
printf("Элемент в хвосте peekLast = %d\r\n", peekLastNum);
/* Добавление элемента в очередь */
pushLast(deque, 4);
printf("После вставки элемента 4 в хвост дек =");
printLinkedListDeque(deque);
pushFirst(deque, 1);
printf("После вставки элемента 1 в голову дек =");
printLinkedListDeque(deque);
/* Извлечение элемента из очереди */
int popLastNum = popLast(deque);
printf("Извлечен элемент из хвоста popLast = %d, дек после извлечения из хвоста = ", popLastNum);
printLinkedListDeque(deque);
int popFirstNum = popFirst(deque);
printf("Извлечен элемент из головы popFirst = %d, дек после извлечения из головы = ", popFirstNum);
printLinkedListDeque(deque);
/* Получение длины очереди */
int dequeSize = size(deque);
printf("Длина дека size = %d\r\n", dequeSize);
/* Проверка, пуста ли очередь */
bool isEmpty = empty(deque);
printf("Пуст ли дек = %s\r\n", isEmpty ? "true" : "false");
// Освободить память
delLinkedListdeque(deque);
return 0;
}
@@ -0,0 +1,128 @@
/**
* File: linkedlist_queue.c
* Created Time: 2023-03-13
* Author: Gonglja (glj0@outlook.com)
*/
#include "../utils/common.h"
/* Очередь на основе связного списка */
typedef struct {
ListNode *front, *rear;
int queSize;
} LinkedListQueue;
/* Конструктор */
LinkedListQueue *newLinkedListQueue() {
LinkedListQueue *queue = (LinkedListQueue *)malloc(sizeof(LinkedListQueue));
queue->front = NULL;
queue->rear = NULL;
queue->queSize = 0;
return queue;
}
/* Деструктор */
void delLinkedListQueue(LinkedListQueue *queue) {
// Освободить все узлы
while (queue->front != NULL) {
ListNode *tmp = queue->front;
queue->front = queue->front->next;
free(tmp);
}
// Освободить структуру queue
free(queue);
}
/* Получение длины очереди */
int size(LinkedListQueue *queue) {
return queue->queSize;
}
/* Проверка, пуста ли очередь */
bool empty(LinkedListQueue *queue) {
return (size(queue) == 0);
}
/* Поместить в очередь */
void push(LinkedListQueue *queue, int num) {
// Добавить node в хвост
ListNode *node = newListNode(num);
// Если очередь пуста, сделать так, чтобы и head, и tail указывали на этот узел
if (queue->front == NULL) {
queue->front = node;
queue->rear = node;
}
// Если очередь не пуста, добавить этот узел после хвостового узла
else {
queue->rear->next = node;
queue->rear = node;
}
queue->queSize++;
}
/* Доступ к элементу в начале очереди */
int peek(LinkedListQueue *queue) {
assert(size(queue) && queue->front);
return queue->front->val;
}
/* Извлечь из очереди */
int pop(LinkedListQueue *queue) {
int num = peek(queue);
ListNode *tmp = queue->front;
queue->front = queue->front->next;
free(tmp);
queue->queSize--;
return num;
}
/* Вывести очередь */
void printLinkedListQueue(LinkedListQueue *queue) {
int *arr = malloc(sizeof(int) * queue->queSize);
// Скопировать данные связного списка в массив
int i;
ListNode *node;
for (i = 0, node = queue->front; i < queue->queSize; i++) {
arr[i] = node->val;
node = node->next;
}
printArray(arr, queue->queSize);
free(arr);
}
/* Driver Code */
int main() {
/* Инициализация очереди */
LinkedListQueue *queue = newLinkedListQueue();
/* Добавление элемента в очередь */
push(queue, 1);
push(queue, 3);
push(queue, 2);
push(queue, 5);
push(queue, 4);
printf("Очередь queue = ");
printLinkedListQueue(queue);
/* Доступ к элементу в начале очереди */
int peekNum = peek(queue);
printf("Элемент в голове peek = %d\r\n", peekNum);
/* Извлечение элемента из очереди */
peekNum = pop(queue);
printf("Извлечен элемент из очереди pop = %d, очередь после извлечения = ", peekNum);
printLinkedListQueue(queue);
/* Получение длины очереди */
int queueSize = size(queue);
printf("Длина очереди size = %d\r\n", queueSize);
/* Проверка, пуста ли очередь */
bool isEmpty = empty(queue);
printf("Пуста ли очередь = %s\r\n", isEmpty ? "true" : "false");
// Освободить память
delLinkedListQueue(queue);
return 0;
}
@@ -0,0 +1,107 @@
/**
* File: linkedlist_stack.c
* Created Time: 2023-01-12
* Author: Zero (glj0@outlook.com)
*/
#include "../utils/common.h"
/* Стек на основе связного списка */
typedef struct {
ListNode *top; // Использовать головной узел как вершину стека
int size; // Длина стека
} LinkedListStack;
/* Конструктор */
LinkedListStack *newLinkedListStack() {
LinkedListStack *s = malloc(sizeof(LinkedListStack));
s->top = NULL;
s->size = 0;
return s;
}
/* Деструктор */
void delLinkedListStack(LinkedListStack *s) {
while (s->top) {
ListNode *n = s->top->next;
free(s->top);
s->top = n;
}
free(s);
}
/* Получение длины стека */
int size(LinkedListStack *s) {
return s->size;
}
/* Проверка, пуст ли стек */
bool isEmpty(LinkedListStack *s) {
return size(s) == 0;
}
/* Поместить в стек */
void push(LinkedListStack *s, int num) {
ListNode *node = (ListNode *)malloc(sizeof(ListNode));
node->next = s->top; // Обновить поле указателя нового узла
node->val = num; // Обновить поле данных нового узла
s->top = node; // Обновить вершину стека
s->size++; // Обновить размер стека
}
/* Доступ к верхнему элементу стека */
int peek(LinkedListStack *s) {
if (s->size == 0) {
printf("стек пуст\n");
return INT_MAX;
}
return s->top->val;
}
/* Извлечь из стека */
int pop(LinkedListStack *s) {
int val = peek(s);
ListNode *tmp = s->top;
s->top = s->top->next;
// Освободить память
free(tmp);
s->size--;
return val;
}
/* Driver Code */
int main() {
/* Инициализация стека */
LinkedListStack *stack = newLinkedListStack();
/* Помещение элемента в стек */
push(stack, 1);
push(stack, 3);
push(stack, 2);
push(stack, 5);
push(stack, 4);
printf("Стек stack = ");
printLinkedList(stack->top);
/* Доступ к верхнему элементу стека */
int val = peek(stack);
printf("Верхний элемент стека top = %d\r\n", val);
/* Извлечение элемента из стека */
val = pop(stack);
printf("Извлечен элемент из стека pop = %d, стек после извлечения = ", val);
printLinkedList(stack->top);
/* Получение длины стека */
printf("Длина стека size = %d\n", size(stack));
/* Проверка на пустоту */
bool empty = isEmpty(stack);
printf("Пуст ли стек = %s\n", empty ? "true" : "false");
// Освободить память
delLinkedListStack(stack);
return 0;
}