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,117 @@
"""
File: array_hash_map.py
Created Time: 2022-12-14
Author: msk397 (machangxinq@gmail.com)
"""
class Pair:
"""Пара ключ-значение"""
def __init__(self, key: int, val: str):
self.key = key
self.val = val
class ArrayHashMap:
"""Хеш-таблица на основе массива"""
def __init__(self):
"""Конструктор"""
# Инициализировать массив, содержащий 100 корзин
self.buckets: list[Pair | None] = [None] * 100
def hash_func(self, key: int) -> int:
"""Хеш-функция"""
index = key % 100
return index
def get(self, key: int) -> str | None:
"""Операция поиска"""
index: int = self.hash_func(key)
pair: Pair = self.buckets[index]
if pair is None:
return None
return pair.val
def put(self, key: int, val: str):
"""Операции добавления и обновления"""
pair = Pair(key, val)
index: int = self.hash_func(key)
self.buckets[index] = pair
def remove(self, key: int):
"""Операция удаления"""
index: int = self.hash_func(key)
# Присвоить None, что означает удаление
self.buckets[index] = None
def entry_set(self) -> list[Pair]:
"""Получить все пары ключ-значение"""
result: list[Pair] = []
for pair in self.buckets:
if pair is not None:
result.append(pair)
return result
def key_set(self) -> list[int]:
"""Получить все ключи"""
result = []
for pair in self.buckets:
if pair is not None:
result.append(pair.key)
return result
def value_set(self) -> list[str]:
"""Получить все значения"""
result = []
for pair in self.buckets:
if pair is not None:
result.append(pair.val)
return result
def print(self):
"""Вывести хеш-таблицу"""
for pair in self.buckets:
if pair is not None:
print(pair.key, "->", pair.val)
"""Driver Code"""
if __name__ == "__main__":
# Инициализация хеш-таблицы
hmap = ArrayHashMap()
# Операция добавления
# Добавить пару (key, value) в хеш-таблицу
hmap.put(12836, "Сяо Ха")
hmap.put(15937, "Сяо Ло")
hmap.put(16750, "Сяо Суань")
hmap.put(13276, "Сяо Фа")
hmap.put(10583, "Сяо Я")
print("\nПосле добавления хеш-таблица имеет вид\nКлюч -> Значение")
hmap.print()
# Операция поиска
# Передать ключ key в хеш-таблицу и получить значение value
name = hmap.get(15937)
print("\nДля номера 15937 найдено имя " + name)
# Операция удаления
# Удалить пару (key, value) из хеш-таблицы
hmap.remove(10583)
print("\nПосле удаления 10583 хеш-таблица имеет вид\nКлюч -> Значение")
hmap.print()
# Обход хеш-таблицы
print("\nОтдельный обход пар ключ-значение")
for pair in hmap.entry_set():
print(pair.key, "->", pair.val)
print("\nОтдельный обход ключей")
for key in hmap.key_set():
print(key)
print("\nОтдельный обход значений")
for val in hmap.value_set():
print(val)
@@ -0,0 +1,37 @@
"""
File: built_in_hash.py
Created Time: 2023-06-15
Author: krahets (krahets@163.com)
"""
import sys
from pathlib import Path
sys.path.append(str(Path(__file__).parent.parent))
from modules import ListNode
"""Driver Code"""
if __name__ == "__main__":
num = 3
hash_num = hash(num)
print(f"Хеш-значение целого числа {num} = {hash_num}")
bol = True
hash_bol = hash(bol)
print(f"Хеш-значение булева значения {bol} = {hash_bol}")
dec = 3.14159
hash_dec = hash(dec)
print(f"Хеш-значение десятичного числа {dec} = {hash_dec}")
str = "Hello Algo"
hash_str = hash(str)
print(f"Хеш-значение строки {str} = {hash_str}")
tup = (12836, "Сяо Ха")
hash_tup = hash(tup)
print(f"Хеш-значение кортежа {tup} = {hash(hash_tup)}")
obj = ListNode(0)
hash_obj = hash(obj)
print(f"Хеш-значение объекта узла {obj} = {hash_obj}")
@@ -0,0 +1,50 @@
"""
File: hash_map.py
Created Time: 2022-12-14
Author: msk397 (machangxinq@gmail.com)
"""
import sys
from pathlib import Path
sys.path.append(str(Path(__file__).parent.parent))
from modules import print_dict
"""Driver Code"""
if __name__ == "__main__":
# Инициализация хеш-таблицы
hmap = dict[int, str]()
# Операция добавления
# Добавить пару (key, value) в хеш-таблицу
hmap[12836] = "Сяо Ха"
hmap[15937] = "Сяо Ло"
hmap[16750] = "Сяо Суань"
hmap[13276] = "Сяо Фа"
hmap[10583] = "Сяо Я"
print("\nПосле добавления хеш-таблица имеет вид\nКлюч -> Значение")
print_dict(hmap)
# Операция поиска
# Передать ключ key в хеш-таблицу и получить значение value
name: str = hmap[15937]
print("\nДля номера 15937 найдено имя " + name)
# Операция удаления
# Удалить пару (key, value) из хеш-таблицы
hmap.pop(10583)
print("\nПосле удаления 10583 хеш-таблица имеет вид\nКлюч -> Значение")
print_dict(hmap)
# Обход хеш-таблицы
print("\nОтдельный обход пар ключ-значение")
for key, value in hmap.items():
print(key, "->", value)
print("\nОтдельный обход ключей")
for key in hmap.keys():
print(key)
print("\nОтдельный обход значений")
for val in hmap.values():
print(val)
@@ -0,0 +1,118 @@
"""
File: hash_map_chaining.py
Created Time: 2023-06-13
Author: krahets (krahets@163.com)
"""
import sys
from pathlib import Path
sys.path.append(str(Path(__file__).parent.parent))
from chapter_hashing.array_hash_map import Pair
class HashMapChaining:
"""Хеш-таблица с цепочками"""
def __init__(self):
"""Конструктор"""
self.size = 0 # Число пар ключ-значение
self.capacity = 4 # Вместимость хеш-таблицы
self.load_thres = 2.0 / 3.0 # Порог коэффициента загрузки для запуска расширения
self.extend_ratio = 2 # Коэффициент расширения
self.buckets = [[] for _ in range(self.capacity)] # Массив корзин
def hash_func(self, key: int) -> int:
"""Хеш-функция"""
return key % self.capacity
def load_factor(self) -> float:
"""Коэффициент загрузки"""
return self.size / self.capacity
def get(self, key: int) -> str | None:
"""Операция поиска"""
index = self.hash_func(key)
bucket = self.buckets[index]
# Обойти корзину; если найден key, вернуть соответствующее val
for pair in bucket:
if pair.key == key:
return pair.val
# Если key не найден, вернуть None
return None
def put(self, key: int, val: str):
"""Операция добавления"""
# Когда коэффициент загрузки превышает порог, выполнить расширение
if self.load_factor() > self.load_thres:
self.extend()
index = self.hash_func(key)
bucket = self.buckets[index]
# Обойти корзину; если встретился указанный key, обновить соответствующее val и вернуть
for pair in bucket:
if pair.key == key:
pair.val = val
return
# Если такого key нет, добавить пару ключ-значение в конец
pair = Pair(key, val)
bucket.append(pair)
self.size += 1
def remove(self, key: int):
"""Операция удаления"""
index = self.hash_func(key)
bucket = self.buckets[index]
# Обойти корзину и удалить из нее пару ключ-значение
for pair in bucket:
if pair.key == key:
bucket.remove(pair)
self.size -= 1
break
def extend(self):
"""Расширить хеш-таблицу"""
# Временно сохранить исходную хеш-таблицу
buckets = self.buckets
# Инициализация новой хеш-таблицы после расширения
self.capacity *= self.extend_ratio
self.buckets = [[] for _ in range(self.capacity)]
self.size = 0
# Перенести пары ключ-значение из исходной хеш-таблицы в новую
for bucket in buckets:
for pair in bucket:
self.put(pair.key, pair.val)
def print(self):
"""Вывести хеш-таблицу"""
for bucket in self.buckets:
res = []
for pair in bucket:
res.append(str(pair.key) + " -> " + pair.val)
print(res)
"""Driver Code"""
if __name__ == "__main__":
# Инициализация хеш-таблицы
hashmap = HashMapChaining()
# Операция добавления
# Добавить пару (key, value) в хеш-таблицу
hashmap.put(12836, "Сяо Ха")
hashmap.put(15937, "Сяо Ло")
hashmap.put(16750, "Сяо Суань")
hashmap.put(13276, "Сяо Фа")
hashmap.put(10583, "Сяо Я")
print("\nПосле завершения добавления хеш-таблица имеет вид\n[Key1 -> Value1, Key2 -> Value2, ...]")
hashmap.print()
# Операция поиска
# Передать ключ key в хеш-таблицу и получить значение value
name = hashmap.get(13276)
print("\nДля номера 13276 найдено имя " + name)
# Операция удаления
# Удалить пару (key, value) из хеш-таблицы
hashmap.remove(12836)
print("\nПосле удаления 12836 хеш-таблица имеет вид\n[Key1 -> Value1, Key2 -> Value2, ...]")
hashmap.print()
@@ -0,0 +1,138 @@
"""
File: hash_map_open_addressing.py
Created Time: 2023-06-13
Author: krahets (krahets@163.com)
"""
import sys
from pathlib import Path
sys.path.append(str(Path(__file__).parent.parent))
from chapter_hashing.array_hash_map import Pair
class HashMapOpenAddressing:
"""Хеш-таблица с открытой адресацией"""
def __init__(self):
"""Конструктор"""
self.size = 0 # Число пар ключ-значение
self.capacity = 4 # Вместимость хеш-таблицы
self.load_thres = 2.0 / 3.0 # Порог коэффициента загрузки для запуска расширения
self.extend_ratio = 2 # Коэффициент расширения
self.buckets: list[Pair | None] = [None] * self.capacity # Массив корзин
self.TOMBSTONE = Pair(-1, "-1") # Удалить метку
def hash_func(self, key: int) -> int:
"""Хеш-функция"""
return key % self.capacity
def load_factor(self) -> float:
"""Коэффициент загрузки"""
return self.size / self.capacity
def find_bucket(self, key: int) -> int:
"""Найти индекс корзины, соответствующий key"""
index = self.hash_func(key)
first_tombstone = -1
# Выполнять линейное пробирование и завершить при встрече с пустой корзиной
while self.buckets[index] is not None:
# Если встретился key, вернуть соответствующий индекс корзины
if self.buckets[index].key == key:
# Если ранее встретилась метка удаления, переместить пару ключ-значение на этот индекс
if first_tombstone != -1:
self.buckets[first_tombstone] = self.buckets[index]
self.buckets[index] = self.TOMBSTONE
return first_tombstone # Вернуть индекс корзины после перемещения
return index # Вернуть индекс корзины
# Записать первую встретившуюся метку удаления
if first_tombstone == -1 and self.buckets[index] is self.TOMBSTONE:
first_tombstone = index
# Вычислить индекс корзины; при выходе за конец вернуться к началу
index = (index + 1) % self.capacity
# Если key не существует, вернуть индекс точки добавления
return index if first_tombstone == -1 else first_tombstone
def get(self, key: int) -> str:
"""Операция поиска"""
# Найти индекс корзины, соответствующий key
index = self.find_bucket(key)
# Если пара ключ-значение найдена, вернуть соответствующее val
if self.buckets[index] not in [None, self.TOMBSTONE]:
return self.buckets[index].val
# Если пара ключ-значение не существует, вернуть None
return None
def put(self, key: int, val: str):
"""Операция добавления"""
# Когда коэффициент загрузки превышает порог, выполнить расширение
if self.load_factor() > self.load_thres:
self.extend()
# Найти индекс корзины, соответствующий key
index = self.find_bucket(key)
# Если пара ключ-значение найдена, перезаписать val и вернуть
if self.buckets[index] not in [None, self.TOMBSTONE]:
self.buckets[index].val = val
return
# Если пары ключ-значение нет, добавить ее
self.buckets[index] = Pair(key, val)
self.size += 1
def remove(self, key: int):
"""Операция удаления"""
# Найти индекс корзины, соответствующий key
index = self.find_bucket(key)
# Если пара ключ-значение найдена, заменить ее меткой удаления
if self.buckets[index] not in [None, self.TOMBSTONE]:
self.buckets[index] = self.TOMBSTONE
self.size -= 1
def extend(self):
"""Расширить хеш-таблицу"""
# Временно сохранить исходную хеш-таблицу
buckets_tmp = self.buckets
# Инициализация новой хеш-таблицы после расширения
self.capacity *= self.extend_ratio
self.buckets = [None] * self.capacity
self.size = 0
# Перенести пары ключ-значение из исходной хеш-таблицы в новую
for pair in buckets_tmp:
if pair not in [None, self.TOMBSTONE]:
self.put(pair.key, pair.val)
def print(self):
"""Вывести хеш-таблицу"""
for pair in self.buckets:
if pair is None:
print("None")
elif pair is self.TOMBSTONE:
print("TOMBSTONE")
else:
print(pair.key, "->", pair.val)
"""Driver Code"""
if __name__ == "__main__":
# Инициализация хеш-таблицы
hashmap = HashMapOpenAddressing()
# Операция добавления
# Добавить пару (key, val) в хеш-таблицу
hashmap.put(12836, "Сяо Ха")
hashmap.put(15937, "Сяо Ло")
hashmap.put(16750, "Сяо Суань")
hashmap.put(13276, "Сяо Фа")
hashmap.put(10583, "Сяо Я")
print("\nПосле добавления хеш-таблица имеет вид\nКлюч -> Значение")
hashmap.print()
# Операция поиска
# Передать ключ key в хеш-таблицу и получить значение val
name = hashmap.get(13276)
print("\nДля номера 13276 найдено имя " + name)
# Операция удаления
# Удалить пару (key, val) из хеш-таблицы
hashmap.remove(16750)
print("\nПосле удаления 16750 хеш-таблица имеет вид\nКлюч -> Значение")
hashmap.print()
@@ -0,0 +1,58 @@
"""
File: simple_hash.py
Created Time: 2023-06-15
Author: krahets (krahets@163.com)
"""
def add_hash(key: str) -> int:
"""Аддитивное хеширование"""
hash = 0
modulus = 1000000007
for c in key:
hash += ord(c)
return hash % modulus
def mul_hash(key: str) -> int:
"""Мультипликативное хеширование"""
hash = 0
modulus = 1000000007
for c in key:
hash = 31 * hash + ord(c)
return hash % modulus
def xor_hash(key: str) -> int:
"""XOR-хеширование"""
hash = 0
modulus = 1000000007
for c in key:
hash ^= ord(c)
return hash % modulus
def rot_hash(key: str) -> int:
"""Хеширование с циклическим сдвигом"""
hash = 0
modulus = 1000000007
for c in key:
hash = (hash << 4) ^ (hash >> 28) ^ ord(c)
return hash % modulus
"""Driver Code"""
if __name__ == "__main__":
key = "Hello Algo"
hash = add_hash(key)
print(f"Хеш-сумма сложением = {hash}")
hash = mul_hash(key)
print(f"Хеш-сумма умножением = {hash}")
hash = xor_hash(key)
print(f"Хеш-сумма XOR = {hash}")
hash = rot_hash(key)
print(f"Хеш-сумма с циклическим сдвигом = {hash}")