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,148 @@
/**
* File: array_deque.swift
* Created Time: 2023-02-22
* Author: nuomi1 (nuomi1@qq.com)
*/
/* Двусторонняя очередь на основе кольцевого массива */
class ArrayDeque {
private var nums: [Int] // Массив для хранения элементов двусторонней очереди
private var front: Int // Указатель head, указывающий на первый элемент очереди
private var _size: Int // Длина двусторонней очереди
/* Конструктор */
init(capacity: Int) {
nums = Array(repeating: 0, count: capacity)
front = 0
_size = 0
}
/* Получить вместимость двусторонней очереди */
func capacity() -> Int {
nums.count
}
/* Получение длины двусторонней очереди */
func size() -> Int {
_size
}
/* Проверка, пуста ли двусторонняя очередь */
func isEmpty() -> Bool {
size() == 0
}
/* Вычислить индекс в кольцевом массиве */
private func index(i: Int) -> Int {
// С помощью операции взятия по модулю соединить начало и конец массива
// Когда i выходит за конец массива, он возвращается в начало
// Когда i выходит за начало массива, он возвращается в конец
(i + capacity()) % capacity()
}
/* Добавление в голову очереди */
func pushFirst(num: Int) {
if size() == capacity() {
print("Двусторонняя очередь заполнена")
return
}
// Указатель головы сдвигается на одну позицию влево
// С помощью операции взятия по модулю front после выхода за начало массива возвращается в хвост
front = index(i: front - 1)
// Добавить num в голову очереди
nums[front] = num
_size += 1
}
/* Добавление в хвост очереди */
func pushLast(num: Int) {
if size() == capacity() {
print("Двусторонняя очередь заполнена")
return
}
// Вычислить указатель хвоста, указывающий на индекс хвоста + 1
let rear = index(i: front + size())
// Добавить num в хвост очереди
nums[rear] = num
_size += 1
}
/* Извлечение из головы очереди */
func popFirst() -> Int {
let num = peekFirst()
// Указатель головы сдвигается на одну позицию назад
front = index(i: front + 1)
_size -= 1
return num
}
/* Извлечение из хвоста очереди */
func popLast() -> Int {
let num = peekLast()
_size -= 1
return num
}
/* Доступ к элементу в начале очереди */
func peekFirst() -> Int {
if isEmpty() {
fatalError("двусторонняя очередь пуста")
}
return nums[front]
}
/* Доступ к элементу в конце очереди */
func peekLast() -> Int {
if isEmpty() {
fatalError("двусторонняя очередь пуста")
}
// Вычислить индекс хвостового элемента
let last = index(i: front + size() - 1)
return nums[last]
}
/* Вернуть массив для вывода */
func toArray() -> [Int] {
// Преобразовывать только элементы списка в пределах фактической длины
(front ..< front + size()).map { nums[index(i: $0)] }
}
}
@main
enum _ArrayDeque {
/* Driver Code */
static func main() {
/* Инициализация двусторонней очереди */
let deque = ArrayDeque(capacity: 10)
deque.pushLast(num: 3)
deque.pushLast(num: 2)
deque.pushLast(num: 5)
print("Двусторонняя очередь deque = \(deque.toArray())")
/* Доступ к элементу */
let peekFirst = deque.peekFirst()
print("Первый элемент peekFirst = \(peekFirst)")
let peekLast = deque.peekLast()
print("Последний элемент peekLast = \(peekLast)")
/* Добавление элемента в очередь */
deque.pushLast(num: 4)
print("После добавления элемента 4 в хвост deque = \(deque.toArray())")
deque.pushFirst(num: 1)
print("После добавления элемента 1 в голову deque = \(deque.toArray())")
/* Извлечение элемента из очереди */
let popLast = deque.popLast()
print("Извлеченный из хвоста элемент = \(popLast), deque после извлечения из хвоста = \(deque.toArray())")
let popFirst = deque.popFirst()
print("Извлеченный из головы элемент = \(popFirst), deque после извлечения из головы = \(deque.toArray())")
/* Получение длины двусторонней очереди */
let size = deque.size()
print("Длина двусторонней очереди size = \(size)")
/* Проверка, пуста ли двусторонняя очередь */
let isEmpty = deque.isEmpty()
print("Пуста ли двусторонняя очередь = \(isEmpty)")
}
}
@@ -0,0 +1,113 @@
/**
* File: array_queue.swift
* Created Time: 2023-01-11
* Author: nuomi1 (nuomi1@qq.com)
*/
/* Очередь на основе кольцевого массива */
class ArrayQueue {
private var nums: [Int] // Массив для хранения элементов очереди
private var front: Int // Указатель head, указывающий на первый элемент очереди
private var _size: Int // Длина очереди
init(capacity: Int) {
// Инициализация массива
nums = Array(repeating: 0, count: capacity)
front = 0
_size = 0
}
/* Получить вместимость очереди */
func capacity() -> Int {
nums.count
}
/* Получение длины очереди */
func size() -> Int {
_size
}
/* Проверка, пуста ли очередь */
func isEmpty() -> Bool {
size() == 0
}
/* Поместить в очередь */
func push(num: Int) {
if size() == capacity() {
print("Очередь заполнена")
return
}
// Вычислить указатель хвоста, указывающий на индекс хвоста + 1
// С помощью операции взятия по модулю вернуть rear к началу после выхода за конец массива
let rear = (front + size()) % capacity()
// Добавить num в хвост очереди
nums[rear] = num
_size += 1
}
/* Извлечь из очереди */
@discardableResult
func pop() -> Int {
let num = peek()
// Указатель head сдвигается на одну позицию назад; если он выходит за конец, то возвращается в начало массива
front = (front + 1) % capacity()
_size -= 1
return num
}
/* Доступ к элементу в начале очереди */
func peek() -> Int {
if isEmpty() {
fatalError("очередь пуста")
}
return nums[front]
}
/* Вернуть массив */
func toArray() -> [Int] {
// Преобразовывать только элементы списка в пределах фактической длины
(front ..< front + size()).map { nums[$0 % capacity()] }
}
}
@main
enum _ArrayQueue {
/* Driver Code */
static func main() {
/* Инициализация очереди */
let capacity = 10
let queue = ArrayQueue(capacity: capacity)
/* Добавление элемента в очередь */
queue.push(num: 1)
queue.push(num: 3)
queue.push(num: 2)
queue.push(num: 5)
queue.push(num: 4)
print("Очередь queue = \(queue.toArray())")
/* Доступ к элементу в начале очереди */
let peek = queue.peek()
print("Первый элемент peek = \(peek)")
/* Извлечение элемента из очереди */
let pop = queue.pop()
print("Извлеченный элемент pop = \(pop), queue после извлечения = \(queue.toArray())")
/* Получение длины очереди */
let size = queue.size()
print("Длина очереди size = \(size)")
/* Проверка, пуста ли очередь */
let isEmpty = queue.isEmpty()
print("Пуста ли очередь = \(isEmpty)")
/* Проверка кольцевого массива */
for i in 0 ..< 10 {
queue.push(num: i)
queue.pop()
print("После \(i)-го раунда операций enqueue и dequeue queue = \(queue.toArray())")
}
}
}
@@ -0,0 +1,85 @@
/**
* File: array_stack.swift
* Created Time: 2023-01-09
* Author: nuomi1 (nuomi1@qq.com)
*/
/* Стек на основе массива */
class ArrayStack {
private var stack: [Int]
init() {
// Инициализация списка (динамического массива)
stack = []
}
/* Получение длины стека */
func size() -> Int {
stack.count
}
/* Проверка, пуст ли стек */
func isEmpty() -> Bool {
stack.isEmpty
}
/* Поместить в стек */
func push(num: Int) {
stack.append(num)
}
/* Извлечь из стека */
@discardableResult
func pop() -> Int {
if isEmpty() {
fatalError("стек пуст")
}
return stack.removeLast()
}
/* Доступ к верхнему элементу стека */
func peek() -> Int {
if isEmpty() {
fatalError("стек пуст")
}
return stack.last!
}
/* Преобразовать List в Array и вернуть */
func toArray() -> [Int] {
stack
}
}
@main
enum _ArrayStack {
/* Driver Code */
static func main() {
/* Инициализация стека */
let stack = ArrayStack()
/* Помещение элемента в стек */
stack.push(num: 1)
stack.push(num: 3)
stack.push(num: 2)
stack.push(num: 5)
stack.push(num: 4)
print("Стек stack = \(stack.toArray())")
/* Доступ к верхнему элементу стека */
let peek = stack.peek()
print("Верхний элемент peek = \(peek)")
/* Извлечение элемента из стека */
let pop = stack.pop()
print("Извлеченный элемент pop = \(pop), stack после извлечения = \(stack.toArray())")
/* Получение длины стека */
let size = stack.size()
print("Длина стека size = \(size)")
/* Проверка на пустоту */
let isEmpty = stack.isEmpty()
print("Пуст ли стек = \(isEmpty)")
}
}
@@ -0,0 +1,44 @@
/**
* File: deque.swift
* Created Time: 2023-01-14
* Author: nuomi1 (nuomi1@qq.com)
*/
@main
enum Deque {
/* Driver Code */
static func main() {
/* Инициализация двусторонней очереди */
// В Swift нет встроенного класса двусторонней очереди, поэтому Array можно использовать как двустороннюю очередь
var deque: [Int] = []
/* Добавление элемента в очередь */
deque.append(2)
deque.append(5)
deque.append(4)
deque.insert(3, at: 0)
deque.insert(1, at: 0)
print("Двусторонняя очередь deque = \(deque)")
/* Доступ к элементу */
let peekFirst = deque.first!
print("Первый элемент peekFirst = \(peekFirst)")
let peekLast = deque.last!
print("Последний элемент peekLast = \(peekLast)")
/* Извлечение элемента из очереди */
// При использовании Array для имитации popFirst имеет сложность O(n)
let popFirst = deque.removeFirst()
print("Извлеченный из головы элемент popFirst = \(popFirst), deque после извлечения из головы = \(deque)")
let popLast = deque.removeLast()
print("Извлеченный из хвоста элемент popLast = \(popLast), deque после извлечения из хвоста = \(deque)")
/* Получение длины двусторонней очереди */
let size = deque.count
print("Длина двусторонней очереди size = \(size)")
/* Проверка, пуста ли двусторонняя очередь */
let isEmpty = deque.isEmpty
print("Пуста ли двусторонняя очередь = \(isEmpty)")
}
}
@@ -0,0 +1,180 @@
/**
* File: linkedlist_deque.swift
* Created Time: 2023-02-22
* Author: nuomi1 (nuomi1@qq.com)
*/
/* Узел двусвязного списка */
class ListNode {
var val: Int // Значение узла
var next: ListNode? // Ссылка на узел-преемник
weak var prev: ListNode? // Ссылка на узел-предшественник
init(val: Int) {
self.val = val
}
}
/* Двусторонняя очередь на основе двусвязного списка */
class LinkedListDeque {
private var front: ListNode? // Головной узел front
private var rear: ListNode? // Хвостовой узел rear
private var _size: Int // Длина двусторонней очереди
init() {
_size = 0
}
/* Получение длины двусторонней очереди */
func size() -> Int {
_size
}
/* Проверка, пуста ли двусторонняя очередь */
func isEmpty() -> Bool {
size() == 0
}
/* Операция добавления в очередь */
private func push(num: Int, isFront: Bool) {
let node = ListNode(val: 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 // Обновить хвостовой узел
}
_size += 1 // Обновить длину очереди
}
/* Добавление в голову очереди */
func pushFirst(num: Int) {
push(num: num, isFront: true)
}
/* Добавление в хвост очереди */
func pushLast(num: Int) {
push(num: num, isFront: false)
}
/* Операция извлечения из очереди */
private func pop(isFront: Bool) -> Int {
if isEmpty() {
fatalError("двусторонняя очередь пуста")
}
let val: Int
// Операция извлечения из головы очереди
if isFront {
val = front!.val // Временно сохранить значение головного узла
// Удалить головной узел
let fNext = front?.next
if fNext != nil {
fNext?.prev = nil
front?.next = nil
}
front = fNext // Обновить головной узел
}
// Операция извлечения из хвоста очереди
else {
val = rear!.val // Временно сохранить значение хвостового узла
// Удалить хвостовой узел
let rPrev = rear?.prev
if rPrev != nil {
rPrev?.next = nil
rear?.prev = nil
}
rear = rPrev // Обновить хвостовой узел
}
_size -= 1 // Обновить длину очереди
return val
}
/* Извлечение из головы очереди */
func popFirst() -> Int {
pop(isFront: true)
}
/* Извлечение из хвоста очереди */
func popLast() -> Int {
pop(isFront: false)
}
/* Доступ к элементу в начале очереди */
func peekFirst() -> Int {
if isEmpty() {
fatalError("двусторонняя очередь пуста")
}
return front!.val
}
/* Доступ к элементу в конце очереди */
func peekLast() -> Int {
if isEmpty() {
fatalError("двусторонняя очередь пуста")
}
return rear!.val
}
/* Вернуть массив для вывода */
func toArray() -> [Int] {
var node = front
var res = Array(repeating: 0, count: size())
for i in res.indices {
res[i] = node!.val
node = node?.next
}
return res
}
}
@main
enum _LinkedListDeque {
/* Driver Code */
static func main() {
/* Инициализация двусторонней очереди */
let deque = LinkedListDeque()
deque.pushLast(num: 3)
deque.pushLast(num: 2)
deque.pushLast(num: 5)
print("Двусторонняя очередь deque = \(deque.toArray())")
/* Доступ к элементу */
let peekFirst = deque.peekFirst()
print("Первый элемент peekFirst = \(peekFirst)")
let peekLast = deque.peekLast()
print("Последний элемент peekLast = \(peekLast)")
/* Добавление элемента в очередь */
deque.pushLast(num: 4)
print("После добавления элемента 4 в хвост deque = \(deque.toArray())")
deque.pushFirst(num: 1)
print("После добавления элемента 1 в голову deque = \(deque.toArray())")
/* Извлечение элемента из очереди */
let popLast = deque.popLast()
print("Извлеченный из хвоста элемент = \(popLast), deque после извлечения из хвоста = \(deque.toArray())")
let popFirst = deque.popFirst()
print("Извлеченный из головы элемент = \(popFirst), deque после извлечения из головы = \(deque.toArray())")
/* Получение длины двусторонней очереди */
let size = deque.size()
print("Длина двусторонней очереди size = \(size)")
/* Проверка, пуста ли двусторонняя очередь */
let isEmpty = deque.isEmpty()
print("Пуста ли двусторонняя очередь = \(isEmpty)")
}
}
@@ -0,0 +1,107 @@
/**
* File: linkedlist_queue.swift
* Created Time: 2023-01-11
* Author: nuomi1 (nuomi1@qq.com)
*/
import utils
/* Очередь на основе связного списка */
class LinkedListQueue {
private var front: ListNode? // Головной узел
private var rear: ListNode? // Хвостовой узел
private var _size: Int
init() {
_size = 0
}
/* Получение длины очереди */
func size() -> Int {
_size
}
/* Проверка, пуста ли очередь */
func isEmpty() -> Bool {
size() == 0
}
/* Поместить в очередь */
func push(num: Int) {
// Добавить num после хвостового узла
let node = ListNode(x: num)
// Если очередь пуста, сделать так, чтобы и head, и tail указывали на этот узел
if front == nil {
front = node
rear = node
}
// Если очередь не пуста, добавить этот узел после хвостового узла
else {
rear?.next = node
rear = node
}
_size += 1
}
/* Извлечь из очереди */
@discardableResult
func pop() -> Int {
let num = peek()
// Удалить головной узел
front = front?.next
_size -= 1
return num
}
/* Доступ к элементу в начале очереди */
func peek() -> Int {
if isEmpty() {
fatalError("очередь пуста")
}
return front!.val
}
/* Преобразовать связный список в Array и вернуть */
func toArray() -> [Int] {
var node = front
var res = Array(repeating: 0, count: size())
for i in res.indices {
res[i] = node!.val
node = node?.next
}
return res
}
}
@main
enum _LinkedListQueue {
/* Driver Code */
static func main() {
/* Инициализация очереди */
let queue = LinkedListQueue()
/* Добавление элемента в очередь */
queue.push(num: 1)
queue.push(num: 3)
queue.push(num: 2)
queue.push(num: 5)
queue.push(num: 4)
print("Очередь queue = \(queue.toArray())")
/* Доступ к элементу в начале очереди */
let peek = queue.peek()
print("Первый элемент peek = \(peek)")
/* Извлечение элемента из очереди */
let pop = queue.pop()
print("Извлеченный элемент pop = \(pop), queue после извлечения = \(queue.toArray())")
/* Получение длины очереди */
let size = queue.size()
print("Длина очереди size = \(size)")
/* Проверка, пуста ли очередь */
let isEmpty = queue.isEmpty()
print("Пуста ли очередь = \(isEmpty)")
}
}
@@ -0,0 +1,96 @@
/**
* File: linkedlist_stack.swift
* Created Time: 2023-01-09
* Author: nuomi1 (nuomi1@qq.com)
*/
import utils
/* Стек на основе связного списка */
class LinkedListStack {
private var _peek: ListNode? // Использовать головной узел как вершину стека
private var _size: Int // Длина стека
init() {
_size = 0
}
/* Получение длины стека */
func size() -> Int {
_size
}
/* Проверка, пуст ли стек */
func isEmpty() -> Bool {
size() == 0
}
/* Поместить в стек */
func push(num: Int) {
let node = ListNode(x: num)
node.next = _peek
_peek = node
_size += 1
}
/* Извлечь из стека */
@discardableResult
func pop() -> Int {
let num = peek()
_peek = _peek?.next
_size -= 1
return num
}
/* Доступ к верхнему элементу стека */
func peek() -> Int {
if isEmpty() {
fatalError("стек пуст")
}
return _peek!.val
}
/* Преобразовать List в Array и вернуть */
func toArray() -> [Int] {
var node = _peek
var res = Array(repeating: 0, count: size())
for i in res.indices.reversed() {
res[i] = node!.val
node = node?.next
}
return res
}
}
@main
enum _LinkedListStack {
/* Driver Code */
static func main() {
/* Инициализация стека */
let stack = LinkedListStack()
/* Помещение элемента в стек */
stack.push(num: 1)
stack.push(num: 3)
stack.push(num: 2)
stack.push(num: 5)
stack.push(num: 4)
print("Стек stack = \(stack.toArray())")
/* Доступ к верхнему элементу стека */
let peek = stack.peek()
print("Верхний элемент peek = \(peek)")
/* Извлечение элемента из стека */
let pop = stack.pop()
print("Извлеченный элемент pop = \(pop), stack после извлечения = \(stack.toArray())")
/* Получение длины стека */
let size = stack.size()
print("Длина стека size = \(size)")
/* Проверка на пустоту */
let isEmpty = stack.isEmpty()
print("Пуст ли стек = \(isEmpty)")
}
}
@@ -0,0 +1,40 @@
/**
* File: queue.swift
* Created Time: 2023-01-11
* Author: nuomi1 (nuomi1@qq.com)
*/
@main
enum Queue {
/* Driver Code */
static func main() {
/* Инициализация очереди */
// В Swift нет встроенного класса очереди, поэтому Array можно использовать как очередь
var queue: [Int] = []
/* Добавление элемента в очередь */
queue.append(1)
queue.append(3)
queue.append(2)
queue.append(5)
queue.append(4)
print("Очередь queue = \(queue)")
/* Доступ к элементу в начале очереди */
let peek = queue.first!
print("Первый элемент peek = \(peek)")
/* Извлечение элемента из очереди */
// При использовании Array для имитации pop имеет сложность O(n)
let pool = queue.removeFirst()
print("Извлеченный элемент pop = \(pool), queue после извлечения = \(queue)")
/* Получение длины очереди */
let size = queue.count
print("Длина очереди size = \(size)")
/* Проверка, пуста ли очередь */
let isEmpty = queue.isEmpty
print("Пуста ли очередь = \(isEmpty)")
}
}
@@ -0,0 +1,39 @@
/**
* File: stack.swift
* Created Time: 2023-01-09
* Author: nuomi1 (nuomi1@qq.com)
*/
@main
enum Stack {
/* Driver Code */
static func main() {
/* Инициализация стека */
// В Swift нет встроенного класса стека, поэтому Array можно использовать как стек
var stack: [Int] = []
/* Помещение элемента в стек */
stack.append(1)
stack.append(3)
stack.append(2)
stack.append(5)
stack.append(4)
print("Стек stack = \(stack)")
/* Доступ к верхнему элементу стека */
let peek = stack.last!
print("Верхний элемент peek = \(peek)")
/* Извлечение элемента из стека */
let pop = stack.removeLast()
print("Извлеченный элемент pop = \(pop), stack после извлечения = \(stack)")
/* Получение длины стека */
let size = stack.count
print("Длина стека size = \(size)")
/* Проверка на пустоту */
let isEmpty = stack.isEmpty
print("Пуст ли стек = \(isEmpty)")
}
}