feat: Traditional Chinese version (#1163)

* First commit * Update mkdocs.yml * Translate all the docs to traditional Chinese * Translate the code files. * Translate the docker file * Fix mkdocs.yml * Translate all the figures from SC to TC * 二叉搜尋樹 -> 二元搜尋樹 * Update terminology. * Update terminology * 构造函数/构造方法 -> 建構子异或 -> 互斥或 * 擴充套件 -> 擴展 * constant - 常量 - 常數 * 類 -> 類別 * AVL -> AVL 樹 * 數組 -> 陣列 * 係統 -> 系統斐波那契數列 -> 費波那契數列運算元量 -> 運算量引數 -> 參數 * 聯絡 -> 關聯 * 麵試 -> 面試 * 面向物件 -> 物件導向歸併排序 -> 合併排序范式 -> 範式 * Fix 算法 -> 演算法 * 錶示 -> 表示反碼 -> 一補數補碼 -> 二補數列列尾部 -> 佇列尾部區域性性 -> 區域性一摞 -> 一疊 * Synchronize with main branch * 賬號 -> 帳號推匯 -> 推導 * Sync with main branch * First commit * Update mkdocs.yml * Translate all the docs to traditional Chinese * Translate the code files. * Translate the docker file * Fix mkdocs.yml * Translate all the figures from SC to TC * 二叉搜尋樹 -> 二元搜尋樹 * Update terminology * 构造函数/构造方法 -> 建構子异或 -> 互斥或 * 擴充套件 -> 擴展 * constant - 常量 - 常數 * 類 -> 類別 * AVL -> AVL 樹 * 數組 -> 陣列 * 係統 -> 系統斐波那契數列 -> 費波那契數列運算元量 -> 運算量引數 -> 參數 * 聯絡 -> 關聯 * 麵試 -> 面試 * 面向物件 -> 物件導向歸併排序 -> 合併排序范式 -> 範式 * Fix 算法 -> 演算法 * 錶示 -> 表示反碼 -> 一補數補碼 -> 二補數列列尾部 -> 佇列尾部區域性性 -> 區域性一摞 -> 一疊 * Synchronize with main branch * 賬號 -> 帳號推匯 -> 推導 * Sync with main branch * Update terminology.md * 操作数量（num. of operations）-> 操作數量 * 字首和->前綴和 * Update figures * 歸 -> 迴記憶體洩漏 -> 記憶體流失 * Fix the bug of the file filter * 支援 -> 支持 Add zh-Hant/README.md * Add the zh-Hant chapter covers. Bug fixes. * 外掛 -> 擴充功能 * Add the landing page for zh-Hant version * Unify the font of the chapter covers for the zh, en, and zh-Hant version * Move zh-Hant/ to zh-hant/ * Translate terminology.md to traditional Chinese
2026-04-13 14:39:44 +08:00 · 2024-04-06 02:30:11 +08:00
parent 33d7f8a2e5
commit 5f7385c8a3
1875 changed files with 102923 additions and 18 deletions
--- a/zh-hant/codes/java/chapter_hashing/array_hash_map.java
+++ b/zh-hant/codes/java/chapter_hashing/array_hash_map.java
@@ -0,0 +1,141 @@
+/**
+ * File: array_hash_map.java
+ * Created Time: 2022-12-04
+ * Author: krahets (krahets@163.com)
+ */
+
+package chapter_hashing;
+
+import java.util.*;
+
+/* 鍵值對 */
+class Pair {
+    public int key;
+    public String val;
+
+    public Pair(int key, String val) {
+        this.key = key;
+        this.val = val;
+    }
+}
+
+/* 基於陣列實現的雜湊表 */
+class ArrayHashMap {
+    private List<Pair> buckets;
+
+    public ArrayHashMap() {
+        // 初始化陣列，包含 100 個桶
+        buckets = new ArrayList<>();
+        for (int i = 0; i < 100; i++) {
+            buckets.add(null);
+        }
+    }
+
+    /* 雜湊函式 */
+    private int hashFunc(int key) {
+        int index = key % 100;
+        return index;
+    }
+
+    /* 查詢操作 */
+    public String get(int key) {
+        int index = hashFunc(key);
+        Pair pair = buckets.get(index);
+        if (pair == null)
+            return null;
+        return pair.val;
+    }
+
+    /* 新增操作 */
+    public void put(int key, String val) {
+        Pair pair = new Pair(key, val);
+        int index = hashFunc(key);
+        buckets.set(index, pair);
+    }
+
+    /* 刪除操作 */
+    public void remove(int key) {
+        int index = hashFunc(key);
+        // 置為 null ，代表刪除
+        buckets.set(index, null);
+    }
+
+    /* 獲取所有鍵值對 */
+    public List<Pair> pairSet() {
+        List<Pair> pairSet = new ArrayList<>();
+        for (Pair pair : buckets) {
+            if (pair != null)
+                pairSet.add(pair);
+        }
+        return pairSet;
+    }
+
+    /* 獲取所有鍵 */
+    public List<Integer> keySet() {
+        List<Integer> keySet = new ArrayList<>();
+        for (Pair pair : buckets) {
+            if (pair != null)
+                keySet.add(pair.key);
+        }
+        return keySet;
+    }
+
+    /* 獲取所有值 */
+    public List<String> valueSet() {
+        List<String> valueSet = new ArrayList<>();
+        for (Pair pair : buckets) {
+            if (pair != null)
+                valueSet.add(pair.val);
+        }
+        return valueSet;
+    }
+
+    /* 列印雜湊表 */
+    public void print() {
+        for (Pair kv : pairSet()) {
+            System.out.println(kv.key + " -> " + kv.val);
+        }
+    }
+}
+
+public class array_hash_map {
+    public static void main(String[] args) {
+        /* 初始化雜湊表 */
+        ArrayHashMap map = new ArrayHashMap();
+
+        /* 新增操作 */
+        // 在雜湊表中新增鍵值對 (key, value)
+        map.put(12836, "小哈");
+        map.put(15937, "小囉");
+        map.put(16750, "小算");
+        map.put(13276, "小法");
+        map.put(10583, "小鴨");
+        System.out.println("\n新增完成後，雜湊表為\nKey -> Value");
+        map.print();
+
+        /* 查詢操作 */
+        // 向雜湊表中輸入鍵 key ，得到值 value
+        String name = map.get(15937);
+        System.out.println("\n輸入學號 15937 ，查詢到姓名 " + name);
+
+        /* 刪除操作 */
+        // 在雜湊表中刪除鍵值對 (key, value)
+        map.remove(10583);
+        System.out.println("\n刪除 10583 後，雜湊表為\nKey -> Value");
+        map.print();
+
+        /* 走訪雜湊表 */
+        System.out.println("\n走訪鍵值對 Key->Value");
+        for (Pair kv : map.pairSet()) {
+            System.out.println(kv.key + " -> " + kv.val);
+        }
+        System.out.println("\n單獨走訪鍵 Key");
+        for (int key : map.keySet()) {
+            System.out.println(key);
+        }
+        System.out.println("\n單獨走訪值 Value");
+        for (String val : map.valueSet()) {
+            System.out.println(val);
+        }
+    }
+}
--- a/zh-hant/codes/java/chapter_hashing/built_in_hash.java
+++ b/zh-hant/codes/java/chapter_hashing/built_in_hash.java
@@ -0,0 +1,38 @@
+/**
+ * File: built_in_hash.java
+ * Created Time: 2023-06-21
+ * Author: krahets (krahets@163.com)
+ */
+
+package chapter_hashing;
+
+import utils.*;
+import java.util.*;
+
+public class built_in_hash {
+    public static void main(String[] args) {
+        int num = 3;
+        int hashNum = Integer.hashCode(num);
+        System.out.println("整數 " + num + " 的雜湊值為 " + hashNum);
+
+        boolean bol = true;
+        int hashBol = Boolean.hashCode(bol);
+        System.out.println("布林量 " + bol + " 的雜湊值為 " + hashBol);
+
+        double dec = 3.14159;
+        int hashDec = Double.hashCode(dec);
+        System.out.println("小數 " + dec + " 的雜湊值為 " + hashDec);
+
+        String str = "Hello 演算法";
+        int hashStr = str.hashCode();
+        System.out.println("字串 " + str + " 的雜湊值為 " + hashStr);
+
+        Object[] arr = { 12836, "小哈" };
+        int hashTup = Arrays.hashCode(arr);
+        System.out.println("陣列 " + Arrays.toString(arr) + " 的雜湊值為 " + hashTup);
+
+        ListNode obj = new ListNode(0);
+        int hashObj = obj.hashCode();
+        System.out.println("節點物件 " + obj + " 的雜湊值為 " + hashObj);
+    }
+}
--- a/zh-hant/codes/java/chapter_hashing/hash_map.java
+++ b/zh-hant/codes/java/chapter_hashing/hash_map.java
@@ -0,0 +1,52 @@
+/**
+ * File: hash_map.java
+ * Created Time: 2022-12-04
+ * Author: krahets (krahets@163.com)
+ */
+
+package chapter_hashing;
+
+import java.util.*;
+import utils.*;
+
+public class hash_map {
+    public static void main(String[] args) {
+        /* 初始化雜湊表 */
+        Map<Integer, String> map = new HashMap<>();
+
+        /* 新增操作 */
+        // 在雜湊表中新增鍵值對 (key, value)
+        map.put(12836, "小哈");
+        map.put(15937, "小囉");
+        map.put(16750, "小算");
+        map.put(13276, "小法");
+        map.put(10583, "小鴨");
+        System.out.println("\n新增完成後，雜湊表為\nKey -> Value");
+        PrintUtil.printHashMap(map);
+
+        /* 查詢操作 */
+        // 向雜湊表中輸入鍵 key ，得到值 value
+        String name = map.get(15937);
+        System.out.println("\n輸入學號 15937 ，查詢到姓名 " + name);
+
+        /* 刪除操作 */
+        // 在雜湊表中刪除鍵值對 (key, value)
+        map.remove(10583);
+        System.out.println("\n刪除 10583 後，雜湊表為\nKey -> Value");
+        PrintUtil.printHashMap(map);
+
+        /* 走訪雜湊表 */
+        System.out.println("\n走訪鍵值對 Key->Value");
+        for (Map.Entry<Integer, String> kv : map.entrySet()) {
+            System.out.println(kv.getKey() + " -> " + kv.getValue());
+        }
+        System.out.println("\n單獨走訪鍵 Key");
+        for (int key : map.keySet()) {
+            System.out.println(key);
+        }
+        System.out.println("\n單獨走訪值 Value");
+        for (String val : map.values()) {
+            System.out.println(val);
+        }
+    }
+}
--- a/zh-hant/codes/java/chapter_hashing/hash_map_chaining.java
+++ b/zh-hant/codes/java/chapter_hashing/hash_map_chaining.java
@@ -0,0 +1,148 @@
+/**
+ * File: hash_map_chaining.java
+ * Created Time: 2023-06-13
+ * Author: krahets (krahets@163.com)
+ */
+
+package chapter_hashing;
+
+import java.util.ArrayList;
+import java.util.List;
+
+/* 鏈式位址雜湊表 */
+class HashMapChaining {
+    int size; // 鍵值對數量
+    int capacity; // 雜湊表容量
+    double loadThres; // 觸發擴容的負載因子閾值
+    int extendRatio; // 擴容倍數
+    List<List<Pair>> buckets; // 桶陣列
+
+    /* 建構子 */
+    public HashMapChaining() {
+        size = 0;
+        capacity = 4;
+        loadThres = 2.0 / 3.0;
+        extendRatio = 2;
+        buckets = new ArrayList<>(capacity);
+        for (int i = 0; i < capacity; i++) {
+            buckets.add(new ArrayList<>());
+        }
+    }
+
+    /* 雜湊函式 */
+    int hashFunc(int key) {
+        return key % capacity;
+    }
+
+    /* 負載因子 */
+    double loadFactor() {
+        return (double) size / capacity;
+    }
+
+    /* 查詢操作 */
+    String get(int key) {
+        int index = hashFunc(key);
+        List<Pair> bucket = buckets.get(index);
+        // 走訪桶，若找到 key ，則返回對應 val
+        for (Pair pair : bucket) {
+            if (pair.key == key) {
+                return pair.val;
+            }
+        }
+        // 若未找到 key ，則返回 null
+        return null;
+    }
+
+    /* 新增操作 */
+    void put(int key, String val) {
+        // 當負載因子超過閾值時，執行擴容
+        if (loadFactor() > loadThres) {
+            extend();
+        }
+        int index = hashFunc(key);
+        List<Pair> bucket = buckets.get(index);
+        // 走訪桶，若遇到指定 key ，則更新對應 val 並返回
+        for (Pair pair : bucket) {
+            if (pair.key == key) {
+                pair.val = val;
+                return;
+            }
+        }
+        // 若無該 key ，則將鍵值對新增至尾部
+        Pair pair = new Pair(key, val);
+        bucket.add(pair);
+        size++;
+    }
+
+    /* 刪除操作 */
+    void remove(int key) {
+        int index = hashFunc(key);
+        List<Pair> bucket = buckets.get(index);
+        // 走訪桶，從中刪除鍵值對
+        for (Pair pair : bucket) {
+            if (pair.key == key) {
+                bucket.remove(pair);
+                size--;
+                break;
+            }
+        }
+    }
+
+    /* 擴容雜湊表 */
+    void extend() {
+        // 暫存原雜湊表
+        List<List<Pair>> bucketsTmp = buckets;
+        // 初始化擴容後的新雜湊表
+        capacity *= extendRatio;
+        buckets = new ArrayList<>(capacity);
+        for (int i = 0; i < capacity; i++) {
+            buckets.add(new ArrayList<>());
+        }
+        size = 0;
+        // 將鍵值對從原雜湊表搬運至新雜湊表
+        for (List<Pair> bucket : bucketsTmp) {
+            for (Pair pair : bucket) {
+                put(pair.key, pair.val);
+            }
+        }
+    }
+
+    /* 列印雜湊表 */
+    void print() {
+        for (List<Pair> bucket : buckets) {
+            List<String> res = new ArrayList<>();
+            for (Pair pair : bucket) {
+                res.add(pair.key + " -> " + pair.val);
+            }
+            System.out.println(res);
+        }
+    }
+}
+
+public class hash_map_chaining {
+    public static void main(String[] args) {
+        /* 初始化雜湊表 */
+        HashMapChaining map = new HashMapChaining();
+
+        /* 新增操作 */
+        // 在雜湊表中新增鍵值對 (key, value)
+        map.put(12836, "小哈");
+        map.put(15937, "小囉");
+        map.put(16750, "小算");
+        map.put(13276, "小法");
+        map.put(10583, "小鴨");
+        System.out.println("\n新增完成後，雜湊表為\nKey -> Value");
+        map.print();
+
+        /* 查詢操作 */
+        // 向雜湊表中輸入鍵 key ，得到值 value
+        String name = map.get(13276);
+        System.out.println("\n輸入學號 13276 ，查詢到姓名 " + name);
+
+        /* 刪除操作 */
+        // 在雜湊表中刪除鍵值對 (key, value)
+        map.remove(12836);
+        System.out.println("\n刪除 12836 後，雜湊表為\nKey -> Value");
+        map.print();
+    }
+}
--- a/zh-hant/codes/java/chapter_hashing/hash_map_open_addressing.java
+++ b/zh-hant/codes/java/chapter_hashing/hash_map_open_addressing.java
@@ -0,0 +1,158 @@
+/**
+ * File: hash_map_open_addressing.java
+ * Created Time: 2023-06-13
+ * Author: krahets (krahets@163.com)
+ */
+
+package chapter_hashing;
+
+/* 開放定址雜湊表 */
+class HashMapOpenAddressing {
+    private int size; // 鍵值對數量
+    private int capacity = 4; // 雜湊表容量
+    private final double loadThres = 2.0 / 3.0; // 觸發擴容的負載因子閾值
+    private final int extendRatio = 2; // 擴容倍數
+    private Pair[] buckets; // 桶陣列
+    private final Pair TOMBSTONE = new Pair(-1, "-1"); // 刪除標記
+
+    /* 建構子 */
+    public HashMapOpenAddressing() {
+        size = 0;
+        buckets = new Pair[capacity];
+    }
+
+    /* 雜湊函式 */
+    private int hashFunc(int key) {
+        return key % capacity;
+    }
+
+    /* 負載因子 */
+    private double loadFactor() {
+        return (double) size / capacity;
+    }
+
+    /* 搜尋 key 對應的桶索引 */
+    private int findBucket(int key) {
+        int index = hashFunc(key);
+        int 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 firstTombstone == -1 ? index : firstTombstone;
+    }
+
+    /* 查詢操作 */
+    public String get(int key) {
+        // 搜尋 key 對應的桶索引
+        int index = findBucket(key);
+        // 若找到鍵值對，則返回對應 val
+        if (buckets[index] != null && buckets[index] != TOMBSTONE) {
+            return buckets[index].val;
+        }
+        // 若鍵值對不存在，則返回 null
+        return null;
+    }
+
+    /* 新增操作 */
+    public void put(int key, String val) {
+        // 當負載因子超過閾值時，執行擴容
+        if (loadFactor() > loadThres) {
+            extend();
+        }
+        // 搜尋 key 對應的桶索引
+        int index = findBucket(key);
+        // 若找到鍵值對，則覆蓋 val 並返回
+        if (buckets[index] != null && buckets[index] != TOMBSTONE) {
+            buckets[index].val = val;
+            return;
+        }
+        // 若鍵值對不存在，則新增該鍵值對
+        buckets[index] = new Pair(key, val);
+        size++;
+    }
+
+    /* 刪除操作 */
+    public void remove(int key) {
+        // 搜尋 key 對應的桶索引
+        int index = findBucket(key);
+        // 若找到鍵值對，則用刪除標記覆蓋它
+        if (buckets[index] != null && buckets[index] != TOMBSTONE) {
+            buckets[index] = TOMBSTONE;
+            size--;
+        }
+    }
+
+    /* 擴容雜湊表 */
+    private void extend() {
+        // 暫存原雜湊表
+        Pair[] bucketsTmp = buckets;
+        // 初始化擴容後的新雜湊表
+        capacity *= extendRatio;
+        buckets = new Pair[capacity];
+        size = 0;
+        // 將鍵值對從原雜湊表搬運至新雜湊表
+        for (Pair pair : bucketsTmp) {
+            if (pair != null && pair != TOMBSTONE) {
+                put(pair.key, pair.val);
+            }
+        }
+    }
+
+    /* 列印雜湊表 */
+    public void print() {
+        for (Pair pair : buckets) {
+            if (pair == null) {
+                System.out.println("null");
+            } else if (pair == TOMBSTONE) {
+                System.out.println("TOMBSTONE");
+            } else {
+                System.out.println(pair.key + " -> " + pair.val);
+            }
+        }
+    }
+}
+
+public class hash_map_open_addressing {
+    public static void main(String[] args) {
+        // 初始化雜湊表
+        HashMapOpenAddressing hashmap = new HashMapOpenAddressing();
+
+        // 新增操作
+        // 在雜湊表中新增鍵值對 (key, val)
+        hashmap.put(12836, "小哈");
+        hashmap.put(15937, "小囉");
+        hashmap.put(16750, "小算");
+        hashmap.put(13276, "小法");
+        hashmap.put(10583, "小鴨");
+        System.out.println("\n新增完成後，雜湊表為\nKey -> Value");
+        hashmap.print();
+
+        // 查詢操作
+        // 向雜湊表中輸入鍵 key ，得到值 val
+        String name = hashmap.get(13276);
+        System.out.println("\n輸入學號 13276 ，查詢到姓名 " + name);
+
+        // 刪除操作
+        // 在雜湊表中刪除鍵值對 (key, val)
+        hashmap.remove(16750);
+        System.out.println("\n刪除 16750 後，雜湊表為\nKey -> Value");
+        hashmap.print();
+    }
+}
--- a/zh-hant/codes/java/chapter_hashing/simple_hash.java
+++ b/zh-hant/codes/java/chapter_hashing/simple_hash.java
@@ -0,0 +1,65 @@
+/**
+ * File: simple_hash.java
+ * Created Time: 2023-06-21
+ * Author: krahets (krahets@163.com)
+ */
+
+package chapter_hashing;
+
+public class simple_hash {
+    /* 加法雜湊 */
+    static int addHash(String key) {
+        long hash = 0;
+        final int MODULUS = 1000000007;
+        for (char c : key.toCharArray()) {
+            hash = (hash + (int) c) % MODULUS;
+        }
+        return (int) hash;
+    }
+
+    /* 乘法雜湊 */
+    static int mulHash(String key) {
+        long hash = 0;
+        final int MODULUS = 1000000007;
+        for (char c : key.toCharArray()) {
+            hash = (31 * hash + (int) c) % MODULUS;
+        }
+        return (int) hash;
+    }
+
+    /* 互斥或雜湊 */
+    static int xorHash(String key) {
+        int hash = 0;
+        final int MODULUS = 1000000007;
+        for (char c : key.toCharArray()) {
+            hash ^= (int) c;
+        }
+        return hash & MODULUS;
+    }
+
+    /* 旋轉雜湊 */
+    static int rotHash(String key) {
+        long hash = 0;
+        final int MODULUS = 1000000007;
+        for (char c : key.toCharArray()) {
+            hash = ((hash << 4) ^ (hash >> 28) ^ (int) c) % MODULUS;
+        }
+        return (int) hash;
+    }
+
+    public static void main(String[] args) {
+        String key = "Hello 演算法";
+
+        int hash = addHash(key);
+        System.out.println("加法雜湊值為 " + hash);
+
+        hash = mulHash(key);
+        System.out.println("乘法雜湊值為 " + hash);
+
+        hash = xorHash(key);
+        System.out.println("互斥或雜湊值為 " + hash);
+
+        hash = rotHash(key);
+        System.out.println("旋轉雜湊值為 " + hash);
+    }
+}