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
2026-09-03 13:47:13 +00:00 · 2026-03-28 04:24:07 +08:00
parent 2ca570cc33
commit 772183705e
1958 changed files with 108186 additions and 0 deletions
@@ -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()
+}