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,129 @@
"""
File: array_deque.py
Created Time: 2023-03-01
Author: krahets (krahets@163.com)
"""
class ArrayDeque:
"""Двусторонняя очередь на основе кольцевого массива"""
def __init__(self, capacity: int):
"""Конструктор"""
self._nums: list[int] = [0] * capacity
self._front: int = 0
self._size: int = 0
def capacity(self) -> int:
"""Получить вместимость двусторонней очереди"""
return len(self._nums)
def size(self) -> int:
"""Получение длины двусторонней очереди"""
return self._size
def is_empty(self) -> bool:
"""Проверка, пуста ли двусторонняя очередь"""
return self._size == 0
def index(self, i: int) -> int:
"""Вычислить индекс в кольцевом массиве"""
# С помощью операции взятия по модулю соединить начало и конец массива
# Когда i выходит за конец массива, он возвращается в начало
# Когда i выходит за начало массива, он возвращается в конец
return (i + self.capacity()) % self.capacity()
def push_first(self, num: int):
"""Добавление в голову очереди"""
if self._size == self.capacity():
print("Двусторонняя очередь заполнена")
return
# Указатель головы сдвигается на одну позицию влево
# С помощью операции взятия по модулю front после выхода за начало массива возвращается в хвост
self._front = self.index(self._front - 1)
# Добавить num в голову очереди
self._nums[self._front] = num
self._size += 1
def push_last(self, num: int):
"""Добавление в хвост очереди"""
if self._size == self.capacity():
print("Двусторонняя очередь заполнена")
return
# Вычислить указатель хвоста, указывающий на индекс хвоста + 1
rear = self.index(self._front + self._size)
# Добавить num в хвост очереди
self._nums[rear] = num
self._size += 1
def pop_first(self) -> int:
"""Извлечение из головы очереди"""
num = self.peek_first()
# Указатель головы сдвигается на одну позицию назад
self._front = self.index(self._front + 1)
self._size -= 1
return num
def pop_last(self) -> int:
"""Извлечение из хвоста очереди"""
num = self.peek_last()
self._size -= 1
return num
def peek_first(self) -> int:
"""Доступ к элементу в начале очереди"""
if self.is_empty():
raise IndexError("двусторонняя очередь пуста")
return self._nums[self._front]
def peek_last(self) -> int:
"""Доступ к элементу в конце очереди"""
if self.is_empty():
raise IndexError("двусторонняя очередь пуста")
# Вычислить индекс хвостового элемента
last = self.index(self._front + self._size - 1)
return self._nums[last]
def to_array(self) -> list[int]:
"""Вернуть массив для вывода"""
# Преобразовывать только элементы списка в пределах фактической длины
res = []
for i in range(self._size):
res.append(self._nums[self.index(self._front + i)])
return res
"""Driver Code"""
if __name__ == "__main__":
# Инициализация двусторонней очереди
deque = ArrayDeque(10)
deque.push_last(3)
deque.push_last(2)
deque.push_last(5)
print("Двусторонняя очередь deque =", deque.to_array())
# Доступ к элементу
peek_first: int = deque.peek_first()
print("Первый элемент peek_first =", peek_first)
peek_last: int = deque.peek_last()
print("Последний элемент peek_last =", peek_last)
# Добавление элемента в очередь
deque.push_last(4)
print("После добавления элемента 4 в хвост deque =", deque.to_array())
deque.push_first(1)
print("После добавления элемента 1 в голову deque =", deque.to_array())
# Извлечение элемента из очереди
pop_last: int = deque.pop_last()
print("Извлеченный из хвоста элемент =", pop_last, ", deque после извлечения из хвоста =", deque.to_array())
pop_first: int = deque.pop_first()
print("Извлеченный из головы элемент =", pop_first, ", deque после извлечения из головы =", deque.to_array())
# Получение длины двусторонней очереди
size: int = deque.size()
print("Длина двусторонней очереди size =", size)
# Проверка, пуста ли двусторонняя очередь
is_empty: bool = deque.is_empty()
print("Пуста ли двусторонняя очередь =", is_empty)
@@ -0,0 +1,98 @@
"""
File: array_queue.py
Created Time: 2022-12-01
Author: Peng Chen (pengchzn@gmail.com)
"""
class ArrayQueue:
"""Очередь на основе кольцевого массива"""
def __init__(self, size: int):
"""Конструктор"""
self._nums: list[int] = [0] * size # Массив для хранения элементов очереди
self._front: int = 0 # Указатель head, указывающий на первый элемент очереди
self._size: int = 0 # Длина очереди
def capacity(self) -> int:
"""Получить вместимость очереди"""
return len(self._nums)
def size(self) -> int:
"""Получение длины очереди"""
return self._size
def is_empty(self) -> bool:
"""Проверка, пуста ли очередь"""
return self._size == 0
def push(self, num: int):
"""Поместить в очередь"""
if self._size == self.capacity():
raise IndexError("очередь заполнена")
# Вычислить указатель хвоста, указывающий на индекс хвоста + 1
# С помощью операции взятия по модулю вернуть rear к началу после выхода за конец массива
rear: int = (self._front + self._size) % self.capacity()
# Добавить num в хвост очереди
self._nums[rear] = num
self._size += 1
def pop(self) -> int:
"""Извлечь из очереди"""
num: int = self.peek()
# Указатель head сдвигается на одну позицию назад; если он выходит за конец, то возвращается в начало массива
self._front = (self._front + 1) % self.capacity()
self._size -= 1
return num
def peek(self) -> int:
"""Доступ к элементу в начале очереди"""
if self.is_empty():
raise IndexError("очередь пуста")
return self._nums[self._front]
def to_list(self) -> list[int]:
"""Вернуть список для вывода"""
res = [0] * self.size()
j: int = self._front
for i in range(self.size()):
res[i] = self._nums[(j % self.capacity())]
j += 1
return res
"""Driver Code"""
if __name__ == "__main__":
# Инициализация очереди
queue = ArrayQueue(10)
# Добавление элемента в очередь
queue.push(1)
queue.push(3)
queue.push(2)
queue.push(5)
queue.push(4)
print("Очередь queue =", queue.to_list())
# Доступ к элементу в начале очереди
peek: int = queue.peek()
print("Первый элемент peek =", peek)
# Извлечение элемента из очереди
pop: int = queue.pop()
print("Извлеченный элемент pop =", pop)
print("queue после извлечения =", queue.to_list())
# Получение длины очереди
size: int = queue.size()
print("Длина очереди size =", size)
# Проверка, пуста ли очередь
is_empty: bool = queue.is_empty()
print("Пуста ли очередь =", is_empty)
# Проверка кольцевого массива
for i in range(10):
queue.push(i)
queue.pop()
print("После", i, "-го раунда операций enqueue и dequeue queue =", queue.to_list())
@@ -0,0 +1,72 @@
"""
File: array_stack.py
Created Time: 2022-11-29
Author: Peng Chen (pengchzn@gmail.com)
"""
class ArrayStack:
"""Стек на основе массива"""
def __init__(self):
"""Конструктор"""
self._stack: list[int] = []
def size(self) -> int:
"""Получение длины стека"""
return len(self._stack)
def is_empty(self) -> bool:
"""Проверка, пуст ли стек"""
return self.size() == 0
def push(self, item: int):
"""Поместить в стек"""
self._stack.append(item)
def pop(self) -> int:
"""Извлечь из стека"""
if self.is_empty():
raise IndexError("стек пуст")
return self._stack.pop()
def peek(self) -> int:
"""Доступ к верхнему элементу стека"""
if self.is_empty():
raise IndexError("стек пуст")
return self._stack[-1]
def to_list(self) -> list[int]:
"""Вернуть список для вывода"""
return self._stack
"""Driver Code"""
if __name__ == "__main__":
# Инициализация стека
stack = ArrayStack()
# Помещение элемента в стек
stack.push(1)
stack.push(3)
stack.push(2)
stack.push(5)
stack.push(4)
print("Стек stack =", stack.to_list())
# Доступ к верхнему элементу стека
peek: int = stack.peek()
print("Верхний элемент peek =", peek)
# Извлечение элемента из стека
pop: int = stack.pop()
print("Извлеченный элемент pop =", pop)
print("stack после извлечения =", stack.to_list())
# Получение длины стека
size: int = stack.size()
print("Длина стека size =", size)
# Проверка на пустоту
is_empty: bool = stack.is_empty()
print("Пуст ли стек =", is_empty)
@@ -0,0 +1,42 @@
"""
File: deque.py
Created Time: 2022-11-29
Author: Peng Chen (pengchzn@gmail.com)
"""
from collections import deque
"""Driver Code"""
if __name__ == "__main__":
# Инициализация двусторонней очереди
deq: deque[int] = deque()
# Добавление элемента в очередь
deq.append(2) # Добавить в хвост очереди
deq.append(5)
deq.append(4)
deq.appendleft(3) # Добавить в голову очереди
deq.appendleft(1)
print("Двусторонняя очередь deque =", deq)
# Доступ к элементу
front: int = deq[0] # Элемент в голове очереди
print("Первый элемент front =", front)
rear: int = deq[-1] # Элемент в хвосте очереди
print("Последний элемент rear =", rear)
# Извлечение элемента из очереди
pop_front: int = deq.popleft() # Извлечь элемент из головы очереди
print("Извлеченный из головы элемент pop_front =", pop_front)
print("deque после извлечения из головы =", deq)
pop_rear: int = deq.pop() # Извлечь элемент из хвоста очереди
print("Извлеченный из хвоста элемент pop_rear =", pop_rear)
print("deque после извлечения из хвоста =", deq)
# Получение длины двусторонней очереди
size: int = len(deq)
print("Длина двусторонней очереди size =", size)
# Проверка, пуста ли двусторонняя очередь
is_empty: bool = len(deq) == 0
print("Пуста ли двусторонняя очередь =", is_empty)
@@ -0,0 +1,151 @@
"""
File: linkedlist_deque.py
Created Time: 2023-03-01
Author: krahets (krahets@163.com)
"""
class ListNode:
"""Узел двусвязного списка"""
def __init__(self, val: int):
"""Конструктор"""
self.val: int = val
self.next: ListNode | None = None # Ссылка на узел-преемник
self.prev: ListNode | None = None # Ссылка на узел-предшественник
class LinkedListDeque:
"""Двусторонняя очередь на основе двусвязного списка"""
def __init__(self):
"""Конструктор"""
self._front: ListNode | None = None # Головной узел front
self._rear: ListNode | None = None # Хвостовой узел rear
self._size: int = 0 # Длина двусторонней очереди
def size(self) -> int:
"""Получение длины двусторонней очереди"""
return self._size
def is_empty(self) -> bool:
"""Проверка, пуста ли двусторонняя очередь"""
return self._size == 0
def push(self, num: int, is_front: bool):
"""Операция добавления в очередь"""
node = ListNode(num)
# Если связный список пуст, сделать так, чтобы и front, и rear указывали на node
if self.is_empty():
self._front = self._rear = node
# Операция добавления в голову очереди
elif is_front:
# Добавить node в голову списка
self._front.prev = node
node.next = self._front
self._front = node # Обновить головной узел
# Операция добавления в хвост очереди
else:
# Добавить node в хвост списка
self._rear.next = node
node.prev = self._rear
self._rear = node # Обновить хвостовой узел
self._size += 1 # Обновить длину очереди
def push_first(self, num: int):
"""Добавление в голову очереди"""
self.push(num, True)
def push_last(self, num: int):
"""Добавление в хвост очереди"""
self.push(num, False)
def pop(self, is_front: bool) -> int:
"""Операция извлечения из очереди"""
if self.is_empty():
raise IndexError("двусторонняя очередь пуста")
# Операция извлечения из головы очереди
if is_front:
val: int = self._front.val # Временно сохранить значение головного узла
# Удалить головной узел
fnext: ListNode | None = self._front.next
if fnext is not None:
fnext.prev = None
self._front.next = None
self._front = fnext # Обновить головной узел
# Операция извлечения из хвоста очереди
else:
val: int = self._rear.val # Временно сохранить значение хвостового узла
# Удалить хвостовой узел
rprev: ListNode | None = self._rear.prev
if rprev is not None:
rprev.next = None
self._rear.prev = None
self._rear = rprev # Обновить хвостовой узел
self._size -= 1 # Обновить длину очереди
return val
def pop_first(self) -> int:
"""Извлечение из головы очереди"""
return self.pop(True)
def pop_last(self) -> int:
"""Извлечение из хвоста очереди"""
return self.pop(False)
def peek_first(self) -> int:
"""Доступ к элементу в начале очереди"""
if self.is_empty():
raise IndexError("двусторонняя очередь пуста")
return self._front.val
def peek_last(self) -> int:
"""Доступ к элементу в конце очереди"""
if self.is_empty():
raise IndexError("двусторонняя очередь пуста")
return self._rear.val
def to_array(self) -> list[int]:
"""Вернуть массив для вывода"""
node = self._front
res = [0] * self.size()
for i in range(self.size()):
res[i] = node.val
node = node.next
return res
"""Driver Code"""
if __name__ == "__main__":
# Инициализация двусторонней очереди
deque = LinkedListDeque()
deque.push_last(3)
deque.push_last(2)
deque.push_last(5)
print("Двусторонняя очередь deque =", deque.to_array())
# Доступ к элементу
peek_first: int = deque.peek_first()
print("Первый элемент peek_first =", peek_first)
peek_last: int = deque.peek_last()
print("Последний элемент peek_last =", peek_last)
# Добавление элемента в очередь
deque.push_last(4)
print("После добавления элемента 4 в хвост deque =", deque.to_array())
deque.push_first(1)
print("После добавления элемента 1 в голову deque =", deque.to_array())
# Извлечение элемента из очереди
pop_last: int = deque.pop_last()
print("Извлеченный из хвоста элемент =", pop_last, ", deque после извлечения из хвоста =", deque.to_array())
pop_first: int = deque.pop_first()
print("Извлеченный из головы элемент =", pop_first, ", deque после извлечения из головы =", deque.to_array())
# Получение длины двусторонней очереди
size: int = deque.size()
print("Длина двусторонней очереди size =", size)
# Проверка, пуста ли двусторонняя очередь
is_empty: bool = deque.is_empty()
print("Пуста ли двусторонняя очередь =", is_empty)
@@ -0,0 +1,97 @@
"""
File: linkedlist_queue.py
Created Time: 2022-12-01
Author: Peng Chen (pengchzn@gmail.com)
"""
import sys
from pathlib import Path
sys.path.append(str(Path(__file__).parent.parent))
from modules import ListNode
class LinkedListQueue:
"""Очередь на основе связного списка"""
def __init__(self):
"""Конструктор"""
self._front: ListNode | None = None # Головной узел front
self._rear: ListNode | None = None # Хвостовой узел rear
self._size: int = 0
def size(self) -> int:
"""Получение длины очереди"""
return self._size
def is_empty(self) -> bool:
"""Проверка, пуста ли очередь"""
return self._size == 0
def push(self, num: int):
"""Поместить в очередь"""
# Добавить num после хвостового узла
node = ListNode(num)
# Если очередь пуста, сделать так, чтобы и head, и tail указывали на этот узел
if self._front is None:
self._front = node
self._rear = node
# Если очередь не пуста, добавить этот узел после хвостового узла
else:
self._rear.next = node
self._rear = node
self._size += 1
def pop(self) -> int:
"""Извлечь из очереди"""
num = self.peek()
# Удалить головной узел
self._front = self._front.next
self._size -= 1
return num
def peek(self) -> int:
"""Доступ к элементу в начале очереди"""
if self.is_empty():
raise IndexError("очередь пуста")
return self._front.val
def to_list(self) -> list[int]:
"""Преобразовать в список для вывода"""
queue = []
temp = self._front
while temp:
queue.append(temp.val)
temp = temp.next
return queue
"""Driver Code"""
if __name__ == "__main__":
# Инициализация очереди
queue = LinkedListQueue()
# Добавление элемента в очередь
queue.push(1)
queue.push(3)
queue.push(2)
queue.push(5)
queue.push(4)
print("Очередь queue =", queue.to_list())
# Доступ к элементу в начале очереди
peek: int = queue.peek()
print("Первый элемент front =", peek)
# Извлечение элемента из очереди
pop_front: int = queue.pop()
print("Извлеченный элемент pop =", pop_front)
print("queue после извлечения =", queue.to_list())
# Получение длины очереди
size: int = queue.size()
print("Длина очереди size =", size)
# Проверка, пуста ли очередь
is_empty: bool = queue.is_empty()
print("Пуста ли очередь =", is_empty)
@@ -0,0 +1,89 @@
"""
File: linkedlist_stack.py
Created Time: 2022-11-29
Author: Peng Chen (pengchzn@gmail.com)
"""
import sys
from pathlib import Path
sys.path.append(str(Path(__file__).parent.parent))
from modules import ListNode
class LinkedListStack:
"""Стек на основе связного списка"""
def __init__(self):
"""Конструктор"""
self._peek: ListNode | None = None
self._size: int = 0
def size(self) -> int:
"""Получение длины стека"""
return self._size
def is_empty(self) -> bool:
"""Проверка, пуст ли стек"""
return self._size == 0
def push(self, val: int):
"""Поместить в стек"""
node = ListNode(val)
node.next = self._peek
self._peek = node
self._size += 1
def pop(self) -> int:
"""Извлечь из стека"""
num = self.peek()
self._peek = self._peek.next
self._size -= 1
return num
def peek(self) -> int:
"""Доступ к верхнему элементу стека"""
if self.is_empty():
raise IndexError("стек пуст")
return self._peek.val
def to_list(self) -> list[int]:
"""Преобразовать в список для вывода"""
arr = []
node = self._peek
while node:
arr.append(node.val)
node = node.next
arr.reverse()
return arr
"""Driver Code"""
if __name__ == "__main__":
# Инициализация стека
stack = LinkedListStack()
# Помещение элемента в стек
stack.push(1)
stack.push(3)
stack.push(2)
stack.push(5)
stack.push(4)
print("Стек stack =", stack.to_list())
# Доступ к верхнему элементу стека
peek: int = stack.peek()
print("Верхний элемент peek =", peek)
# Извлечение элемента из стека
pop: int = stack.pop()
print("Извлеченный элемент pop =", pop)
print("stack после извлечения =", stack.to_list())
# Получение длины стека
size: int = stack.size()
print("Длина стека size =", size)
# Проверка на пустоту
is_empty: bool = stack.is_empty()
print("Пуст ли стек =", is_empty)
@@ -0,0 +1,39 @@
"""
File: queue.py
Created Time: 2022-11-29
Author: Peng Chen (pengchzn@gmail.com)
"""
from collections import deque
"""Driver Code"""
if __name__ == "__main__":
# Инициализировать очередь
# В Python мы обычно рассматриваем двустороннюю очередь deque как очередь
# Хотя queue.Queue() — это «настоящий» класс очереди, им не очень удобно пользоваться
que: deque[int] = deque()
# Добавление элемента в очередь
que.append(1)
que.append(3)
que.append(2)
que.append(5)
que.append(4)
print("Очередь que =", que)
# Доступ к элементу в начале очереди
front: int = que[0]
print("Первый элемент front =", front)
# Извлечение элемента из очереди
pop: int = que.popleft()
print("Извлеченный элемент pop =", pop)
print("que после извлечения =", que)
# Получение длины очереди
size: int = len(que)
print("Длина очереди size =", size)
# Проверка, пуста ли очередь
is_empty: bool = len(que) == 0
print("Пуста ли очередь =", is_empty)
@@ -0,0 +1,36 @@
"""
File: stack.py
Created Time: 2022-11-29
Author: Peng Chen (pengchzn@gmail.com)
"""
"""Driver Code"""
if __name__ == "__main__":
# Инициализировать стек
# В Python нет встроенного класса стека, поэтому list можно использовать как стек
stack: list[int] = []
# Помещение элемента в стек
stack.append(1)
stack.append(3)
stack.append(2)
stack.append(5)
stack.append(4)
print("Стек stack =", stack)
# Доступ к верхнему элементу стека
peek: int = stack[-1]
print("Верхний элемент peek =", peek)
# Извлечение элемента из стека
pop: int = stack.pop()
print("Извлеченный элемент pop =", pop)
print("stack после извлечения =", stack)
# Получение длины стека
size: int = len(stack)
print("Длина стека size =", size)
# Проверка на пустоту
is_empty: bool = len(stack) == 0
print("Пуст ли стек =", is_empty)