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,126 @@
/**
* File: array_hash_map.kt
* Created Time: 2024-01-25
* Author: curtishd (1023632660@qq.com)
*/
package chapter_hashing
/* Пара ключ-значение */
class Pair(
var key: Int,
var _val: String
)
/* Хеш-таблица на основе массива */
class ArrayHashMap {
// Инициализировать массив, содержащий 100 корзин
private val buckets = arrayOfNulls<Pair>(100)
/* Хеш-функция */
fun hashFunc(key: Int): Int {
val index = key % 100
return index
}
/* Операция поиска */
fun get(key: Int): String? {
val index = hashFunc(key)
val pair = buckets[index] ?: return null
return pair._val
}
/* Операция добавления */
fun put(key: Int, _val: String) {
val pair = Pair(key, _val)
val index = hashFunc(key)
buckets[index] = pair
}
/* Операция удаления */
fun remove(key: Int) {
val index = hashFunc(key)
// Присвоить null, что означает удаление
buckets[index] = null
}
/* Получить все пары ключ-значение */
fun pairSet(): MutableList<Pair> {
val pairSet = mutableListOf<Pair>()
for (pair in buckets) {
if (pair != null)
pairSet.add(pair)
}
return pairSet
}
/* Получить все ключи */
fun keySet(): MutableList<Int> {
val keySet = mutableListOf<Int>()
for (pair in buckets) {
if (pair != null)
keySet.add(pair.key)
}
return keySet
}
/* Получить все значения */
fun valueSet(): MutableList<String> {
val valueSet = mutableListOf<String>()
for (pair in buckets) {
if (pair != null)
valueSet.add(pair._val)
}
return valueSet
}
/* Вывести хеш-таблицу */
fun print() {
for (kv in pairSet()) {
val key = kv.key
val _val = kv._val
println("$key -> $_val")
}
}
}
/* Driver Code */
fun main() {
/* Инициализация хеш-таблицы */
val map = ArrayHashMap()
/* Операция добавления */
// Добавить пару (key, value) в хеш-таблицу
map.put(12836, "Сяо Ха")
map.put(15937, "Сяо Ло")
map.put(16750, "Сяо Суань")
map.put(13276, "Сяо Фа")
map.put(10583, "Сяо Я")
println("\nПосле добавления хеш-таблица имеет вид\nКлюч -> Значение")
map.print()
/* Операция поиска */
// Ввести в хеш-таблицу ключ key и получить значение value
val name = map.get(15937)
println("\nДля номера 15937 найдено имя $name")
/* Операция удаления */
// Удалить пару (key, value) из хеш-таблицы
map.remove(10583)
println("\nПосле удаления 10583 хеш-таблица имеет вид\nКлюч -> Значение")
map.print()
/* Обход хеш-таблицы */
println("\nОтдельный обход пар ключ-значение")
for (kv in map.pairSet()) {
println("${kv.key} -> ${kv._val}")
}
println("\nОтдельный обход ключей")
for (key in map.keySet()) {
println(key)
}
println("\nОтдельный обход значений")
for (_val in map.valueSet()) {
println(_val)
}
}
@@ -0,0 +1,36 @@
/**
* File: built_in_hash.kt
* Created Time: 2024-01-25
* Author: curtishd (1023632660@qq.com)
*/
package chapter_hashing
import utils.ListNode
/* Driver Code */
fun main() {
val num = 3
val hashNum = num.hashCode()
println("Хеш-значение целого числа $num = $hashNum")
val bol = true
val hashBol = bol.hashCode()
println("Хеш-значение булева значения $bol = $hashBol")
val dec = 3.14159
val hashDec = dec.hashCode()
println("Хеш-значение десятичного числа $dec = $hashDec")
val str = "Hello Algo"
val hashStr = str.hashCode()
println("Хеш-значение строки $str = $hashStr")
val arr = arrayOf<Any>(12836, "Сяо Ха")
val hashTup = arr.contentHashCode()
println("Хеш-значение массива ${arr.contentToString()} = $hashTup")
val obj = ListNode(0)
val hashObj = obj.hashCode()
println("Хеш-значение объекта узла $obj = $hashObj")
}
@@ -0,0 +1,50 @@
/**
* File: hash_map.kt
* Created Time: 2024-01-25
* Author: curtishd (1023632660@qq.com)
*/
package chapter_hashing
import utils.printHashMap
/* Driver Code */
fun main() {
/* Инициализация хеш-таблицы */
val map = HashMap<Int, String>()
/* Операция добавления */
// Добавить пару (key, value) в хеш-таблицу
map[12836] = "Сяо Ха"
map[15937] = "Сяо Ло"
map[16750] = "Сяо Суань"
map[13276] = "Сяо Фа"
map[10583] = "Сяо Я"
println("\nПосле добавления хеш-таблица имеет вид\nКлюч -> Значение")
printHashMap(map)
/* Операция поиска */
// Ввести в хеш-таблицу ключ key и получить значение value
val name = map[15937]
println("\nДля номера 15937 найдено имя $name")
/* Операция удаления */
// Удалить пару (key, value) из хеш-таблицы
map.remove(10583)
println("\nПосле удаления 10583 хеш-таблица имеет вид\nКлюч -> Значение")
printHashMap(map)
/* Обход хеш-таблицы */
println("\nОтдельный обход пар ключ-значение")
for ((key, value) in map) {
println("$key -> $value")
}
println("\nОтдельный обход ключей")
for (key in map.keys) {
println(key)
}
println("\nОтдельный обход значений")
for (_val in map.values) {
println(_val)
}
}
@@ -0,0 +1,145 @@
/**
* File: hash_map_chaining.kt
* Created Time: 2024-01-25
* Author: curtishd (1023632660@qq.com)
*/
package chapter_hashing
/* Хеш-таблица с цепочками */
class HashMapChaining {
var size: Int // Число пар ключ-значение
var capacity: Int // Вместимость хеш-таблицы
val loadThres: Double // Порог коэффициента загрузки для запуска расширения
val extendRatio: Int // Коэффициент расширения
var buckets: MutableList<MutableList<Pair>> // Массив корзин
/* Конструктор */
init {
size = 0
capacity = 4
loadThres = 2.0 / 3.0
extendRatio = 2
buckets = mutableListOf()
for (i in 0..<capacity) {
buckets.add(mutableListOf())
}
}
/* Хеш-функция */
fun hashFunc(key: Int): Int {
return key % capacity
}
/* Коэффициент загрузки */
fun loadFactor(): Double {
return (size / capacity).toDouble()
}
/* Операция поиска */
fun get(key: Int): String? {
val index = hashFunc(key)
val bucket = buckets[index]
// Обойти корзину; если найден key, вернуть соответствующее val
for (pair in bucket) {
if (pair.key == key) return pair._val
}
// Если key не найден, вернуть null
return null
}
/* Операция добавления */
fun put(key: Int, _val: String) {
// Когда коэффициент загрузки превышает порог, выполнить расширение
if (loadFactor() > loadThres) {
extend()
}
val index = hashFunc(key)
val bucket = buckets[index]
// Обойти корзину; если встретился указанный key, обновить соответствующее val и вернуть
for (pair in bucket) {
if (pair.key == key) {
pair._val = _val
return
}
}
// Если такого key нет, добавить пару ключ-значение в конец
val pair = Pair(key, _val)
bucket.add(pair)
size++
}
/* Операция удаления */
fun remove(key: Int) {
val index = hashFunc(key)
val bucket = buckets[index]
// Обойти корзину и удалить из нее пару ключ-значение
for (pair in bucket) {
if (pair.key == key) {
bucket.remove(pair)
size--
break
}
}
}
/* Расширить хеш-таблицу */
fun extend() {
// Временно сохранить исходную хеш-таблицу
val bucketsTmp = buckets
// Инициализация новой хеш-таблицы после расширения
capacity *= extendRatio
// mutablelist не имеет фиксированного размера
buckets = mutableListOf()
for (i in 0..<capacity) {
buckets.add(mutableListOf())
}
size = 0
// Перенести пары ключ-значение из исходной хеш-таблицы в новую
for (bucket in bucketsTmp) {
for (pair in bucket) {
put(pair.key, pair._val)
}
}
}
/* Вывести хеш-таблицу */
fun print() {
for (bucket in buckets) {
val res = mutableListOf<String>()
for (pair in bucket) {
val k = pair.key
val v = pair._val
res.add("$k -> $v")
}
println(res)
}
}
}
/* Driver Code */
fun main() {
/* Инициализация хеш-таблицы */
val map = HashMapChaining()
/* Операция добавления */
// Добавить пару (key, value) в хеш-таблицу
map.put(12836, "Сяо Ха")
map.put(15937, "Сяо Ло")
map.put(16750, "Сяо Суань")
map.put(13276, "Сяо Фа")
map.put(10583, "Сяо Я")
println("\nПосле добавления хеш-таблица имеет вид\nКлюч -> Значение")
map.print()
/* Операция поиска */
// Ввести в хеш-таблицу ключ key и получить значение value
val name = map.get(13276)
println("\nДля номера 13276 найдено имя $name")
/* Операция удаления */
// Удалить пару (key, value) из хеш-таблицы
map.remove(12836)
println("\nПосле удаления 12836 хеш-таблица имеет вид\nКлюч -> Значение")
map.print()
}
@@ -0,0 +1,161 @@
/**
* File: hash_map_open_addressing.kt
* Created Time: 2024-01-25
* Author: curtishd (1023632660@qq.com)
*/
package chapter_hashing
/* Хеш-таблица с открытой адресацией */
class HashMapOpenAddressing {
private var size: Int // Число пар ключ-значение
private var capacity: Int // Вместимость хеш-таблицы
private val loadThres: Double // Порог коэффициента загрузки для запуска расширения
private val extendRatio: Int // Коэффициент расширения
private var buckets: Array<Pair?> // Массив корзин
private val TOMBSTONE: Pair // Удалить метку
/* Конструктор */
init {
size = 0
capacity = 4
loadThres = 2.0 / 3.0
extendRatio = 2
buckets = arrayOfNulls(capacity)
TOMBSTONE = Pair(-1, "-1")
}
/* Хеш-функция */
fun hashFunc(key: Int): Int {
return key % capacity
}
/* Коэффициент загрузки */
fun loadFactor(): Double {
return (size / capacity).toDouble()
}
/* Найти индекс корзины, соответствующий key */
fun findBucket(key: Int): Int {
var index = hashFunc(key)
var firstTombstone = -1
// Выполнять линейное пробирование и завершить при встрече с пустой корзиной
while (buckets[index] != null) {
// Если встретился key, вернуть соответствующий индекс корзины
if (buckets[index]?.key == key) {
// Если ранее встретилась метка удаления, переместить пару ключ-значение на этот индекс
if (firstTombstone != -1) {
buckets[firstTombstone] = buckets[index]
buckets[index] = TOMBSTONE
return firstTombstone // Вернуть индекс корзины после перемещения
}
return index // Вернуть индекс корзины
}
// Записать первую встретившуюся метку удаления
if (firstTombstone == -1 && buckets[index] == TOMBSTONE) {
firstTombstone = index
}
// Вычислить индекс корзины; при выходе за конец вернуться к началу
index = (index + 1) % capacity
}
// Если key не существует, вернуть индекс точки добавления
return if (firstTombstone == -1) index else firstTombstone
}
/* Операция поиска */
fun get(key: Int): String? {
// Найти индекс корзины, соответствующий key
val index = findBucket(key)
// Если пара ключ-значение найдена, вернуть соответствующее val
if (buckets[index] != null && buckets[index] != TOMBSTONE) {
return buckets[index]?._val
}
// Если пары ключ-значение не существует, вернуть null
return null
}
/* Операция добавления */
fun put(key: Int, _val: String) {
// Когда коэффициент загрузки превышает порог, выполнить расширение
if (loadFactor() > loadThres) {
extend()
}
// Найти индекс корзины, соответствующий key
val index = findBucket(key)
// Если пара ключ-значение найдена, перезаписать val и вернуть
if (buckets[index] != null && buckets[index] != TOMBSTONE) {
buckets[index]!!._val = _val
return
}
// Если пары ключ-значение нет, добавить ее
buckets[index] = Pair(key, _val)
size++
}
/* Операция удаления */
fun remove(key: Int) {
// Найти индекс корзины, соответствующий key
val index = findBucket(key)
// Если пара ключ-значение найдена, заменить ее меткой удаления
if (buckets[index] != null && buckets[index] != TOMBSTONE) {
buckets[index] = TOMBSTONE
size--
}
}
/* Расширить хеш-таблицу */
fun extend() {
// Временно сохранить исходную хеш-таблицу
val bucketsTmp = buckets
// Инициализация новой хеш-таблицы после расширения
capacity *= extendRatio
buckets = arrayOfNulls(capacity)
size = 0
// Перенести пары ключ-значение из исходной хеш-таблицы в новую
for (pair in bucketsTmp) {
if (pair != null && pair != TOMBSTONE) {
put(pair.key, pair._val)
}
}
}
/* Вывести хеш-таблицу */
fun print() {
for (pair in buckets) {
if (pair == null) {
println("null")
} else if (pair == TOMBSTONE) {
println("TOMESTOME")
} else {
println("${pair.key} -> ${pair._val}")
}
}
}
}
/* Driver Code */
fun main() {
// Инициализация хеш-таблицы
val hashmap = HashMapOpenAddressing()
// Операция добавления
// Добавить пару (key, val) в хеш-таблицу
hashmap.put(12836, "Сяо Ха")
hashmap.put(15937, "Сяо Ло")
hashmap.put(16750, "Сяо Суань")
hashmap.put(13276, "Сяо Фа")
hashmap.put(10583, "Сяо Я")
println("\nПосле добавления хеш-таблица имеет вид\nКлюч -> Значение")
hashmap.print()
// Операция поиска
// Передать ключ key в хеш-таблицу и получить значение val
val name = hashmap.get(13276)
println("\nДля номера 13276 найдено имя $name")
// Операция удаления
// Удалить пару (key, val) из хеш-таблицы
hashmap.remove(16750)
println("\nПосле удаления 16750 хеш-таблица имеет вид\nКлюч -> Значение")
hashmap.print()
}
@@ -0,0 +1,64 @@
/**
* File: simple_hash.kt
* Created Time: 2024-01-25
* Author: curtishd (1023632660@qq.com)
*/
package chapter_hashing
/* Аддитивное хеширование */
fun addHash(key: String): Int {
var hash = 0L
val MODULUS = 1000000007
for (c in key.toCharArray()) {
hash = (hash + c.code) % MODULUS
}
return hash.toInt()
}
/* Мультипликативное хеширование */
fun mulHash(key: String): Int {
var hash = 0L
val MODULUS = 1000000007
for (c in key.toCharArray()) {
hash = (31 * hash + c.code) % MODULUS
}
return hash.toInt()
}
/* XOR-хеширование */
fun xorHash(key: String): Int {
var hash = 0
val MODULUS = 1000000007
for (c in key.toCharArray()) {
hash = hash xor c.code
}
return hash and MODULUS
}
/* Хеширование с циклическим сдвигом */
fun rotHash(key: String): Int {
var hash = 0L
val MODULUS = 1000000007
for (c in key.toCharArray()) {
hash = ((hash shl 4) xor (hash shr 28) xor c.code.toLong()) % MODULUS
}
return hash.toInt()
}
/* Driver Code */
fun main() {
val key = "Hello Algo"
var hash = addHash(key)
println("Хеш-сумма сложением = $hash")
hash = mulHash(key)
println("Хеш-сумма умножением = $hash")
hash = xorHash(key)
println("Хеш-сумма XOR = $hash")
hash = rotHash(key)
println("Хеш-сумма с циклическим сдвигом = $hash")
}