Re-translate the Japanese version (#1871)

* Retranslate Japanese docs with GPT-5.4

* Retranslate Japanese code with GPT-5.4

ja/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追加完了後のハッシュテーブルは\nKey -> Value")
+        map.print()
+
+        /* 検索操作 */
+        // キー key をハッシュテーブルに渡し、値 value を取得
+        let name = map.get(key: 15937)!
+        print("\n学籍番号 15937 を入力すると、名前 \(name) が見つかりました")
+
+        /* 削除操作 */
+        // ハッシュテーブルからキーと値のペア (key, value) を削除
+        map.remove(key: 10583)
+        print("\n10583 を削除後のハッシュテーブルは\nKey -> Value")
+        map.print()
+
+        /* ハッシュテーブルを走査 */
+        print("\nキーと値の組 Key->Value を走査")
+        for pair in map.pairSet() {
+            print("\(pair.key) -> \(pair.val)")
+        }
+        print("\nキー Key を個別に走査")
+        for key in map.keySet() {
+            print(key)
+        }
+        print("\n値 Value を個別に走査")
+        for val in map.valueSet() {
+            print(val)
+        }
+    }
+}

ja/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 アルゴリズム"
+        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)")
+    }
+}

ja/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追加完了後のハッシュテーブルは\nKey -> Value")
+        PrintUtil.printHashMap(map: map)
+
+        /* 検索操作 */
+        // キー key をハッシュテーブルに渡し、値 value を取得
+        let name = map[15937]!
+        print("\n学籍番号 15937 を入力すると、名前 \(name) が見つかりました")
+
+        /* 削除操作 */
+        // ハッシュテーブルからキーと値のペア (key, value) を削除
+        map.removeValue(forKey: 10583)
+        print("\n10583 を削除後のハッシュテーブルは\nKey -> Value")
+        PrintUtil.printHashMap(map: map)
+
+        /* ハッシュテーブルを走査 */
+        print("\nキーと値の組 Key->Value を走査")
+        for (key, value) in map {
+            print("\(key) -> \(value)")
+        }
+        print("\nキー Key を個別に走査")
+        for key in map.keys {
+            print(key)
+        }
+        print("\n値 Value を個別に走査")
+        for value in map.values {
+            print(value)
+        }
+    }
+}

ja/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追加完了後のハッシュテーブルは\nKey -> Value")
+        map.print()
+
+        /* 検索操作 */
+        // キー key をハッシュテーブルに渡し、値 value を取得
+        let name = map.get(key: 13276)
+        print("\n学籍番号 13276 を入力すると、名前 \(name!) が見つかりました")
+
+        /* 削除操作 */
+        // ハッシュテーブルからキーと値のペア (key, value) を削除
+        map.remove(key: 12836)
+        print("\n12836 を削除後、ハッシュテーブルは\nKey -> Value")
+        map.print()
+    }
+}

ja/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追加完了後のハッシュテーブルは\nKey -> Value")
+        map.print()
+
+        /* 検索操作 */
+        // キー key をハッシュテーブルに渡し、値 value を取得
+        let name = map.get(key: 13276)
+        print("\n学籍番号 13276 を入力すると、名前 \(name!) が見つかりました")
+
+        /* 削除操作 */
+        // ハッシュテーブルからキーと値のペア (key, value) を削除
+        map.remove(key: 16750)
+        print("\n16750 を削除後、ハッシュテーブルは\nKey -> Value")
+        map.print()
+    }
+}

ja/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 アルゴリズム"
+
+        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)")
+    }
+}