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-08-31 04:17:14 +00:00 · 2024-04-06 02:30:11 +08:00
parent 33d7f8a2e5
commit 5f7385c8a3
1875 changed files with 102923 additions and 18 deletions
@@ -0,0 +1,101 @@
+/**
+ * File: array.kt
+ * Created Time: 2024-01-25
+ * Author: curtishd (1023632660@qq.com)
+ */
+
+package chapter_array_and_linkedlist
+
+import java.util.concurrent.ThreadLocalRandom
+
+/* 隨機訪問元素 */
+fun randomAccess(nums: IntArray): Int {
+    // 在區間 [0, nums.size) 中隨機抽取一個數字
+    val randomIndex = ThreadLocalRandom.current().nextInt(0, nums.size)
+    // 獲取並返回隨機元素
+    val randomNum = nums[randomIndex]
+    return randomNum
+}
+
+/* 擴展陣列長度 */
+fun extend(nums: IntArray, enlarge: Int): IntArray {
+    // 初始化一個擴展長度後的陣列
+    val res = IntArray(nums.size + enlarge)
+    // 將原陣列中的所有元素複製到新陣列
+    for (i in nums.indices) {
+        res[i] = nums[i]
+    }
+    // 返回擴展後的新陣列
+    return res
+}
+
+/* 在陣列的索引 index 處插入元素 num */
+fun insert(nums: IntArray, num: Int, index: Int) {
+    // 把索引 index 以及之後的所有元素向後移動一位
+    for (i in nums.size - 1 downTo index + 1) {
+        nums[i] = nums[i - 1]
+    }
+    // 將 num 賦給 index 處的元素
+    nums[index] = num
+}
+
+/* 刪除索引 index 處的元素 */
+fun remove(nums: IntArray, index: Int) {
+    // 把索引 index 之後的所有元素向前移動一位
+    for (i in index..<nums.size - 1) {
+        nums[i] = nums[i + 1]
+    }
+}
+
+/* 走訪陣列 */
+fun traverse(nums: IntArray) {
+    var count = 0
+    // 透過索引走訪陣列
+    for (i in nums.indices) {
+        count += nums[i]
+    }
+    // 直接走訪陣列元素
+    for (j: Int in nums) {
+        count += j
+    }
+}
+
+/* 在陣列中查詢指定元素 */
+fun find(nums: IntArray, target: Int): Int {
+    for (i in nums.indices) {
+        if (nums[i] == target) return i
+    }
+    return -1
+}
+
+/* Driver Code */
+fun main() {
+    /* 初始化陣列 */
+    val arr = IntArray(5)
+    println("陣列 arr = ${arr.contentToString()}")
+    var nums = intArrayOf(1, 3, 2, 5, 4)
+    println("陣列 nums = ${nums.contentToString()}")
+
+    /* 隨機訪問 */
+    val randomNum: Int = randomAccess(nums)
+    println("在 nums 中獲取隨機元素 $randomNum")
+
+    /* 長度擴展 */
+    nums = extend(nums, 3)
+    println("將陣列長度擴展至 8 ，得到 nums = ${nums.contentToString()}")
+
+    /* 插入元素 */
+    insert(nums, 6, 3)
+    println("在索引 3 處插入數字 6 ，得到 nums = ${nums.contentToString()}")
+
+    /* 刪除元素 */
+    remove(nums, 2)
+    println("刪除索引 2 處的元素，得到 nums = ${nums.contentToString()}")
+
+    /* 走訪陣列 */
+    traverse(nums)
+
+    /* 查詢元素 */
+    val index: Int = find(nums, 3)
+    println("在 nums 中查詢元素 3 ，得到索引 = $index")
+}
@@ -0,0 +1,80 @@
+/**
+ * File: linked_list.kt
+ * Created Time: 2024-01-25
+ * Author: curtishd (1023632660@qq.com)
+ */
+
+package chapter_array_and_linkedlist
+
+import utils.ListNode
+import utils.printLinkedList
+
+/* 在鏈結串列的節點 n0 之後插入節點p */
+fun insert(n0: ListNode?, p: ListNode?) {
+    val n1 = n0?.next
+    p?.next = n1
+    n0?.next = p
+}
+
+/* 刪除鏈結串列的節點 n0 之後的首個節點 */
+fun remove(n0: ListNode?) {
+    val p = n0?.next
+    val n1 = p?.next
+    n0?.next = n1
+}
+
+/* 訪問鏈結串列中索引為 index 的節點 */
+fun access(head: ListNode?, index: Int): ListNode? {
+    var h = head
+    for (i in 0..<index) {
+        h = h?.next
+    }
+    return h
+}
+
+/* 在鏈結串列中查詢值為 target 的首個節點 */
+fun find(head: ListNode?, target: Int): Int {
+    var index = 0
+    var h = head
+    while (h != null) {
+        if (h.value == target) return index
+        h = h.next
+        index++
+    }
+    return -1
+}
+
+/* Driver Code */
+fun main() {
+    // 初始化各個節點
+    val n0 = ListNode(1)
+    val n1 = ListNode(3)
+    val n2 = ListNode(2)
+    val n3 = ListNode(5)
+    val n4 = ListNode(4)
+
+    // 構建節點之間的引用
+    n0.next = n1
+    n1.next = n2
+    n2.next = n3
+    n3.next = n4
+    println("初始化的鏈結串列為")
+    printLinkedList(n0)
+    
+    insert(n0, ListNode(0))
+    println("插入節點後的鏈結串列為")
+    printLinkedList(n0)
+
+    /* 刪除節點 */
+    remove(n0)
+    println("刪除節點後的鏈結串列為")
+    printLinkedList(n0)
+
+    /* 訪問節點 */
+    val node: ListNode = access(n0, 3)!!
+    println("鏈結串列中索引 3 處的節點的值 = ${node.value}")
+
+    /* 查詢節點 */
+    val index: Int = find(n0, 2)
+    println("鏈結串列中值為 2 的節點的索引 = $index")
+}
@@ -0,0 +1,63 @@
+/**
+ * File: list.kt
+ * Created Time: 2024-01-25
+ * Author: curtishd (1023632660@qq.com)
+ */
+
+package chapter_array_and_linkedlist
+
+/* Driver Code */
+fun main() {
+    // 可變集合
+    val numbers = mutableListOf(1, 3, 2, 5, 4)
+    val nums = ArrayList<Int>(numbers)
+    println("串列 nums = $nums")
+
+    /* 訪問元素 */
+    val num = nums[1]
+    println("訪問索引 1 處的元素，得到 num = $num")
+
+    /* 更新元素 */
+    nums[1] = 0
+    println("將索引 1 處的元素更新為 0 ，得到 nums = $nums")
+
+    /* 清空串列 */
+    nums.clear()
+    println("清空串列後 nums = $nums")
+
+    /* 在尾部新增元素 */
+    nums.add(1)
+    nums.add(3)
+    nums.add(2)
+    nums.add(5)
+    nums.add(4)
+    println("新增元素後 nums = $nums")
+
+    /* 在中間插入元素 */
+    nums.add(3, 6)
+    println("在索引 3 處插入數字 6 ，得到 nums = $nums")
+
+    /* 刪除元素 */
+    nums.removeAt(3)
+    println("刪除索引 3 處的元素，得到 nums = $nums")
+
+    /* 透過索引走訪串列 */
+    var count = 0
+    for (i in nums.indices) {
+        count += nums[i]
+    }
+
+    /* 直接走訪串列元素 */
+    for (j in nums) {
+        count += j
+    }
+
+    /* 拼接兩個串列*/
+    val nums1 = ArrayList<Int>(listOf(6, 8, 7, 10, 9))
+    nums.addAll(nums1)
+    println("將串列 nums1 拼接到 nums 之後，得到 nums = $nums")
+
+    /* 排序串列 */
+    nums.sort() //排序後,串列元素從小到大排列
+    println("排序串列後 nums = $nums")
+}
@@ -0,0 +1,139 @@
+/**
+ * File: my_list.kt
+ * Created Time: 2024-01-25
+ * Author: curtishd (1023632660@qq.com)
+ */
+
+package chapter_array_and_linkedlist
+
+/* 串列類別 */
+class MyList {
+    private var arr: IntArray = intArrayOf() // 陣列（儲存串列元素）
+    private var capacity = 10 // 串列容量
+    private var size = 0 // 串列長度（當前元素數量）
+    private var extendRatio = 2 // 每次串列擴容的倍數
+
+    /* 建構子 */
+    init {
+        arr = IntArray(capacity)
+    }
+
+    /* 獲取串列長度（當前元素數量） */
+    fun size(): Int {
+        return size
+    }
+
+    /* 獲取串列容量 */
+    fun capacity(): Int {
+        return capacity
+    }
+
+    /* 訪問元素 */
+    fun get(index: Int): Int {
+        // 索引如果越界，則丟擲異常，下同
+        if (index < 0 || index >= size)
+            throw IndexOutOfBoundsException()
+        return arr[index]
+    }
+
+    /* 更新元素 */
+    fun set(index: Int, num: Int) {
+        if (index < 0 || index >= size)
+            throw IndexOutOfBoundsException("索引越界")
+        arr[index] = num
+    }
+
+    /* 在尾部新增元素 */
+    fun add(num: Int) {
+        // 元素數量超出容量時，觸發擴容機制
+        if (size == capacity())
+            extendCapacity()
+        arr[size] = num
+        // 更新元素數量
+        size++
+    }
+
+    /* 在中間插入元素 */
+    fun insert(index: Int, num: Int) {
+        if (index < 0 || index >= size)
+            throw IndexOutOfBoundsException("索引越界")
+        // 元素數量超出容量時，觸發擴容機制
+        if (size == capacity())
+            extendCapacity()
+        // 將索引 index 以及之後的元素都向後移動一位
+        for (j in size - 1 downTo index)
+            arr[j + 1] = arr[j]
+        arr[index] = num
+        // 更新元素數量
+        size++
+    }
+
+    /* 刪除元素 */
+    fun remove(index: Int): Int {
+        if (index < 0 || index >= size)
+            throw IndexOutOfBoundsException("索引越界")
+        val num: Int = arr[index]
+        // 將將索引 index 之後的元素都向前移動一位
+        for (j in index..<size - 1)
+            arr[j] = arr[j + 1]
+        // 更新元素數量
+        size--
+        // 返回被刪除的元素
+        return num
+    }
+
+    /* 串列擴容 */
+    fun extendCapacity() {
+        // 新建一個長度為原陣列 extendRatio 倍的新陣列，並將原陣列複製到新陣列
+        arr = arr.copyOf(capacity() * extendRatio)
+        // 更新串列容量
+        capacity = arr.size
+    }
+
+    /* 將串列轉換為陣列 */
+    fun toArray(): IntArray {
+        val size = size()
+        // 僅轉換有效長度範圍內的串列元素
+        val arr = IntArray(size)
+        for (i in 0..<size) {
+            arr[i] = get(i)
+        }
+        return arr
+    }
+}
+
+/* Driver Code */
+fun main() {
+    /* 初始化串列 */
+    val nums = MyList()
+    /* 在尾部新增元素 */
+    nums.add(1)
+    nums.add(3)
+    nums.add(2)
+    nums.add(5)
+    nums.add(4)
+    println("串列 nums = ${nums.toArray().contentToString()}，容量 = ${nums.capacity()}，長度 = ${nums.size()}")
+
+    /* 在中間插入元素 */
+    nums.insert(3, 6)
+    println("在索引 3 處插入數字 6 ，得到 nums = ${nums.toArray().contentToString()}")
+
+    /* 刪除元素 */
+    nums.remove(3)
+    println("刪除索引 3 處的元素，得到 nums = ${nums.toArray().contentToString()}")
+
+    /* 訪問元素 */
+    val num = nums.get(1)
+    println("訪問索引 1 處的元素，得到 num = $num")
+
+    /* 更新元素 */
+    nums.set(1, 0)
+    println("將索引 1 處的元素更新為 0 ，得到 nums = ${nums.toArray().contentToString()}")
+
+    /* 測試擴容機制 */
+    for (i in 0..9) {
+        // 在 i = 5 時，串列長度將超出串列容量，此時觸發擴容機制
+        nums.add(i)
+    }
+    println("擴容後的串列 nums = ${nums.toArray().contentToString()}，容量 = ${nums.capacity()}，長度 =  ${nums.size()}")
+}