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

ru/codes/swift/chapter_hashing/array_hash_map.swift

@@ -0,0 +1,110 @@
+/**
+ * File: array_hash_map.swift
+ * Created Time: 2023-01-16
+ * Author: nuomi1 (nuomi1@qq.com)
+ */
+
+import utils
+
+/* Хеш-таблица на основе массива */
+class ArrayHashMap {
+    private var buckets: [Pair?]
+
+    init() {
+        // Инициализировать массив, содержащий 100 корзин
+        buckets = Array(repeating: nil, count: 100)
+    }
+
+    /* Хеш-функция */
+    private func hashFunc(key: Int) -> Int {
+        let index = key % 100
+        return index
+    }
+
+    /* Операция поиска */
+    func get(key: Int) -> String? {
+        let index = hashFunc(key: key)
+        let pair = buckets[index]
+        return pair?.val
+    }
+
+    /* Операция добавления */
+    func put(key: Int, val: String) {
+        let pair = Pair(key: key, val: val)
+        let index = hashFunc(key: key)
+        buckets[index] = pair
+    }
+
+    /* Операция удаления */
+    func remove(key: Int) {
+        let index = hashFunc(key: key)
+        // Присвоить nil, что означает удаление
+        buckets[index] = nil
+    }
+
+    /* Получить все пары ключ-значение */
+    func pairSet() -> [Pair] {
+        buckets.compactMap { $0 }
+    }
+
+    /* Получить все ключи */
+    func keySet() -> [Int] {
+        buckets.compactMap { $0?.key }
+    }
+
+    /* Получить все значения */
+    func valueSet() -> [String] {
+        buckets.compactMap { $0?.val }
+    }
+
+    /* Вывести хеш-таблицу */
+    func print() {
+        for pair in pairSet() {
+            Swift.print("\(pair.key) -> \(pair.val)")
+        }
+    }
+}
+
+@main
+enum _ArrayHashMap {
+    /* Driver Code */
+    static func main() {
+        /* Инициализация хеш-таблицы */
+        let map = ArrayHashMap()
+
+        /* Операция добавления */
+        // Добавить пару (key, value) в хеш-таблицу
+        map.put(key: 12836, val: "Сяо Ха")
+        map.put(key: 15937, val: "Сяо Ло")
+        map.put(key: 16750, val: "Сяо Суань")
+        map.put(key: 13276, val: "Сяо Фа")
+        map.put(key: 10583, val: "Сяо Я")
+        print("\nПосле добавления хеш-таблица имеет вид\nКлюч -> Значение")
+        map.print()
+
+        /* Операция поиска */
+        // Ввести в хеш-таблицу ключ key и получить значение value
+        let name = map.get(key: 15937)!
+        print("\nДля номера 15937 найдено имя \(name)")
+
+        /* Операция удаления */
+        // Удалить пару (key, value) из хеш-таблицы
+        map.remove(key: 10583)
+        print("\nПосле удаления 10583 хеш-таблица имеет вид\nКлюч -> Значение")
+        map.print()
+
+        /* Обход хеш-таблицы */
+        print("\nОтдельный обход пар ключ-значение")
+        for pair in map.pairSet() {
+            print("\(pair.key) -> \(pair.val)")
+        }
+        print("\nОтдельный обход ключей")
+        for key in map.keySet() {
+            print(key)
+        }
+        print("\nОтдельный обход значений")
+        for val in map.valueSet() {
+            print(val)
+        }
+    }
+}

ru/codes/swift/chapter_hashing/built_in_hash.swift

@@ -0,0 +1,37 @@
+/**
+ * File: built_in_hash.swift
+ * Created Time: 2023-07-01
+ * Author: nuomi1 (nuomi1@qq.com)
+ */
+
+import utils
+
+@main
+enum BuiltInHash {
+    /* Driver Code */
+    static func main() {
+        let num = 3
+        let hashNum = num.hashValue
+        print("Хеш-значение целого числа \(num) = \(hashNum)")
+
+        let bol = true
+        let hashBol = bol.hashValue
+        print("Хеш-значение булева значения \(bol) = \(hashBol)")
+
+        let dec = 3.14159
+        let hashDec = dec.hashValue
+        print("Хеш-значение десятичного числа \(dec) = \(hashDec)")
+
+        let str = "Hello Algo"
+        let hashStr = str.hashValue
+        print("Хеш-значение строки \(str) = \(hashStr)")
+
+        let arr = [AnyHashable(12836), AnyHashable("Сяо Ха")]
+        let hashTup = arr.hashValue
+        print("Хеш-значение массива \(arr) = \(hashTup)")
+
+        let obj = ListNode(x: 0)
+        let hashObj = obj.hashValue
+        print("Хеш-значение объекта узла \(obj) = \(hashObj)")
+    }
+}

ru/codes/swift/chapter_hashing/hash_map.swift

@@ -0,0 +1,51 @@
+/**
+ * File: hash_map.swift
+ * Created Time: 2023-01-16
+ * Author: nuomi1 (nuomi1@qq.com)
+ */
+
+import utils
+
+@main
+enum HashMap {
+    /* Driver Code */
+    static func main() {
+        /* Инициализация хеш-таблицы */
+        var map: [Int: String] = [:]
+
+        /* Операция добавления */
+        // Добавить пару (key, value) в хеш-таблицу
+        map[12836] = "Сяо Ха"
+        map[15937] = "Сяо Ло"
+        map[16750] = "Сяо Суань"
+        map[13276] = "Сяо Фа"
+        map[10583] = "Сяо Я"
+        print("\nПосле добавления хеш-таблица имеет вид\nКлюч -> Значение")
+        PrintUtil.printHashMap(map: map)
+
+        /* Операция поиска */
+        // Ввести в хеш-таблицу ключ key и получить значение value
+        let name = map[15937]!
+        print("\nДля номера 15937 найдено имя \(name)")
+
+        /* Операция удаления */
+        // Удалить пару (key, value) из хеш-таблицы
+        map.removeValue(forKey: 10583)
+        print("\nПосле удаления 10583 хеш-таблица имеет вид\nКлюч -> Значение")
+        PrintUtil.printHashMap(map: map)
+
+        /* Обход хеш-таблицы */
+        print("\nОтдельный обход пар ключ-значение")
+        for (key, value) in map {
+            print("\(key) -> \(value)")
+        }
+        print("\nОтдельный обход ключей")
+        for key in map.keys {
+            print(key)
+        }
+        print("\nОтдельный обход значений")
+        for value in map.values {
+            print(value)
+        }
+    }
+}

ru/codes/swift/chapter_hashing/hash_map_chaining.swift

@@ -0,0 +1,138 @@
+/**
+ * File: hash_map_chaining.swift
+ * Created Time: 2023-06-28
+ * Author: nuomi1 (nuomi1@qq.com)
+ */
+
+import utils
+
+/* Хеш-таблица с цепочками */
+class HashMapChaining {
+    var size: Int // Число пар ключ-значение
+    var capacity: Int // Вместимость хеш-таблицы
+    var loadThres: Double // Порог коэффициента загрузки для запуска расширения
+    var extendRatio: Int // Коэффициент расширения
+    var buckets: [[Pair]] // Массив корзин
+
+    /* Конструктор */
+    init() {
+        size = 0
+        capacity = 4
+        loadThres = 2.0 / 3.0
+        extendRatio = 2
+        buckets = Array(repeating: [], count: capacity)
+    }
+
+    /* Хеш-функция */
+    func hashFunc(key: Int) -> Int {
+        key % capacity
+    }
+
+    /* Коэффициент загрузки */
+    func loadFactor() -> Double {
+        Double(size) / Double(capacity)
+    }
+
+    /* Операция поиска */
+    func get(key: Int) -> String? {
+        let index = hashFunc(key: key)
+        let bucket = buckets[index]
+        // Обойти корзину; если найден key, вернуть соответствующее val
+        for pair in bucket {
+            if pair.key == key {
+                return pair.val
+            }
+        }
+        // Если key не найден, вернуть nil
+        return nil
+    }
+
+    /* Операция добавления */
+    func put(key: Int, val: String) {
+        // Когда коэффициент загрузки превышает порог, выполнить расширение
+        if loadFactor() > loadThres {
+            extend()
+        }
+        let index = hashFunc(key: key)
+        let bucket = buckets[index]
+        // Обойти корзину; если встретился указанный key, обновить соответствующее val и вернуть
+        for pair in bucket {
+            if pair.key == key {
+                pair.val = val
+                return
+            }
+        }
+        // Если такого key нет, добавить пару ключ-значение в конец
+        let pair = Pair(key: key, val: val)
+        buckets[index].append(pair)
+        size += 1
+    }
+
+    /* Операция удаления */
+    func remove(key: Int) {
+        let index = hashFunc(key: key)
+        let bucket = buckets[index]
+        // Обойти корзину и удалить из нее пару ключ-значение
+        for (pairIndex, pair) in bucket.enumerated() {
+            if pair.key == key {
+                buckets[index].remove(at: pairIndex)
+                size -= 1
+                break
+            }
+        }
+    }
+
+    /* Расширить хеш-таблицу */
+    func extend() {
+        // Временно сохранить исходную хеш-таблицу
+        let bucketsTmp = buckets
+        // Инициализация новой хеш-таблицы после расширения
+        capacity *= extendRatio
+        buckets = Array(repeating: [], count: capacity)
+        size = 0
+        // Перенести пары ключ-значение из исходной хеш-таблицы в новую
+        for bucket in bucketsTmp {
+            for pair in bucket {
+                put(key: pair.key, val: pair.val)
+            }
+        }
+    }
+
+    /* Вывести хеш-таблицу */
+    func print() {
+        for bucket in buckets {
+            let res = bucket.map { "\($0.key) -> \($0.val)" }
+            Swift.print(res)
+        }
+    }
+}
+
+@main
+enum _HashMapChaining {
+    /* Driver Code */
+    static func main() {
+        /* Инициализация хеш-таблицы */
+        let map = HashMapChaining()
+
+        /* Операция добавления */
+        // Добавить пару (key, value) в хеш-таблицу
+        map.put(key: 12836, val: "Сяо Ха")
+        map.put(key: 15937, val: "Сяо Ло")
+        map.put(key: 16750, val: "Сяо Суань")
+        map.put(key: 13276, val: "Сяо Фа")
+        map.put(key: 10583, val: "Сяо Я")
+        print("\nПосле добавления хеш-таблица имеет вид\nКлюч -> Значение")
+        map.print()
+
+        /* Операция поиска */
+        // Ввести в хеш-таблицу ключ key и получить значение value
+        let name = map.get(key: 13276)
+        print("\nДля номера 13276 найдено имя \(name!)")
+
+        /* Операция удаления */
+        // Удалить пару (key, value) из хеш-таблицы
+        map.remove(key: 12836)
+        print("\nПосле удаления 12836 хеш-таблица имеет вид\nКлюч -> Значение")
+        map.print()
+    }
+}

ru/codes/swift/chapter_hashing/hash_map_open_addressing.swift

@@ -0,0 +1,164 @@
+/**
+ * File: hash_map_open_addressing.swift
+ * Created Time: 2023-06-28
+ * Author: nuomi1 (nuomi1@qq.com)
+ */
+
+import utils
+
+/* Хеш-таблица с открытой адресацией */
+class HashMapOpenAddressing {
+    var size: Int // Число пар ключ-значение
+    var capacity: Int // Вместимость хеш-таблицы
+    var loadThres: Double // Порог коэффициента загрузки для запуска расширения
+    var extendRatio: Int // Коэффициент расширения
+    var buckets: [Pair?] // Массив корзин
+    var TOMBSTONE: Pair // Удалить метку
+
+    /* Конструктор */
+    init() {
+        size = 0
+        capacity = 4
+        loadThres = 2.0 / 3.0
+        extendRatio = 2
+        buckets = Array(repeating: nil, count: capacity)
+        TOMBSTONE = Pair(key: -1, val: "-1")
+    }
+
+    /* Хеш-функция */
+    func hashFunc(key: Int) -> Int {
+        key % capacity
+    }
+
+    /* Коэффициент загрузки */
+    func loadFactor() -> Double {
+        Double(size) / Double(capacity)
+    }
+
+    /* Найти индекс корзины, соответствующий key */
+    func findBucket(key: Int) -> Int {
+        var index = hashFunc(key: key)
+        var firstTombstone = -1
+        // Выполнять линейное пробирование и завершить при встрече с пустой корзиной
+        while buckets[index] != nil {
+            // Если встретился 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 firstTombstone == -1 ? index : firstTombstone
+    }
+
+    /* Операция поиска */
+    func get(key: Int) -> String? {
+        // Найти индекс корзины, соответствующий key
+        let index = findBucket(key: key)
+        // Если пара ключ-значение найдена, вернуть соответствующее val
+        if buckets[index] != nil, buckets[index] != TOMBSTONE {
+            return buckets[index]!.val
+        }
+        // Если пары ключ-значение не существует, вернуть null
+        return nil
+    }
+
+    /* Операция добавления */
+    func put(key: Int, val: String) {
+        // Когда коэффициент загрузки превышает порог, выполнить расширение
+        if loadFactor() > loadThres {
+            extend()
+        }
+        // Найти индекс корзины, соответствующий key
+        let index = findBucket(key: key)
+        // Если пара ключ-значение найдена, перезаписать val и вернуть
+        if buckets[index] != nil, buckets[index] != TOMBSTONE {
+            buckets[index]!.val = val
+            return
+        }
+        // Если пары ключ-значение нет, добавить ее
+        buckets[index] = Pair(key: key, val: val)
+        size += 1
+    }
+
+    /* Операция удаления */
+    func remove(key: Int) {
+        // Найти индекс корзины, соответствующий key
+        let index = findBucket(key: key)
+        // Если пара ключ-значение найдена, заменить ее меткой удаления
+        if buckets[index] != nil, buckets[index] != TOMBSTONE {
+            buckets[index] = TOMBSTONE
+            size -= 1
+        }
+    }
+
+    /* Расширить хеш-таблицу */
+    func extend() {
+        // Временно сохранить исходную хеш-таблицу
+        let bucketsTmp = buckets
+        // Инициализация новой хеш-таблицы после расширения
+        capacity *= extendRatio
+        buckets = Array(repeating: nil, count: capacity)
+        size = 0
+        // Перенести пары ключ-значение из исходной хеш-таблицы в новую
+        for pair in bucketsTmp {
+            if let pair, pair != TOMBSTONE {
+                put(key: pair.key, val: pair.val)
+            }
+        }
+    }
+
+    /* Вывести хеш-таблицу */
+    func print() {
+        for pair in buckets {
+            if pair == nil {
+                Swift.print("null")
+            } else if pair == TOMBSTONE {
+                Swift.print("TOMBSTONE")
+            } else {
+                Swift.print("\(pair!.key) -> \(pair!.val)")
+            }
+        }
+    }
+}
+
+@main
+enum _HashMapOpenAddressing {
+    /* Driver Code */
+    static func main() {
+        /* Инициализация хеш-таблицы */
+        let map = HashMapOpenAddressing()
+
+        /* Операция добавления */
+        // Добавить пару (key, value) в хеш-таблицу
+        map.put(key: 12836, val: "Сяо Ха")
+        map.put(key: 15937, val: "Сяо Ло")
+        map.put(key: 16750, val: "Сяо Суань")
+        map.put(key: 13276, val: "Сяо Фа")
+        map.put(key: 10583, val: "Сяо Я")
+        print("\nПосле добавления хеш-таблица имеет вид\nКлюч -> Значение")
+        map.print()
+
+        /* Операция поиска */
+        // Ввести в хеш-таблицу ключ key и получить значение value
+        let name = map.get(key: 13276)
+        print("\nДля номера 13276 найдено имя \(name!)")
+
+        /* Операция удаления */
+        // Удалить пару (key, value) из хеш-таблицы
+        map.remove(key: 16750)
+        print("\nПосле удаления 16750 хеш-таблица имеет вид\nКлюч -> Значение")
+        map.print()
+    }
+}

ru/codes/swift/chapter_hashing/simple_hash.swift

@@ -0,0 +1,73 @@
+/**
+ * File: simple_hash.swift
+ * Created Time: 2023-07-01
+ * Author: nuomi1 (nuomi1@qq.com)
+ */
+
+/* Аддитивное хеширование */
+func addHash(key: String) -> Int {
+    var hash = 0
+    let MODULUS = 1_000_000_007
+    for c in key {
+        for scalar in c.unicodeScalars {
+            hash = (hash + Int(scalar.value)) % MODULUS
+        }
+    }
+    return hash
+}
+
+/* Мультипликативное хеширование */
+func mulHash(key: String) -> Int {
+    var hash = 0
+    let MODULUS = 1_000_000_007
+    for c in key {
+        for scalar in c.unicodeScalars {
+            hash = (31 * hash + Int(scalar.value)) % MODULUS
+        }
+    }
+    return hash
+}
+
+/* XOR-хеширование */
+func xorHash(key: String) -> Int {
+    var hash = 0
+    let MODULUS = 1_000_000_007
+    for c in key {
+        for scalar in c.unicodeScalars {
+            hash ^= Int(scalar.value)
+        }
+    }
+    return hash & MODULUS
+}
+
+/* Хеширование с циклическим сдвигом */
+func rotHash(key: String) -> Int {
+    var hash = 0
+    let MODULUS = 1_000_000_007
+    for c in key {
+        for scalar in c.unicodeScalars {
+            hash = ((hash << 4) ^ (hash >> 28) ^ Int(scalar.value)) % MODULUS
+        }
+    }
+    return hash
+}
+
+@main
+enum SimpleHash {
+    /* Driver Code */
+    static func main() {
+        let key = "Hello Algo"
+
+        var hash = addHash(key: key)
+        print("Хеш-сумма сложением = \(hash)")
+
+        hash = mulHash(key: key)
+        print("Хеш-сумма умножением = \(hash)")
+
+        hash = xorHash(key: key)
+        print("Хеш-сумма XOR = \(hash)")
+
+        hash = rotHash(key: key)
+        print("Хеш-сумма с циклическим сдвигом = \(hash)")
+    }
+}