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
This commit is contained in:
Yudong Jin
2024-04-06 02:30:11 +08:00
committed by GitHub
parent 33d7f8a2e5
commit 5f7385c8a3
1875 changed files with 102923 additions and 18 deletions
+249
View File
@@ -0,0 +1,249 @@
// File: avl_tree.zig
// Created Time: 2023-01-15
// Author: codingonion (coderonion@gmail.com)
const std = @import("std");
const inc = @import("include");
// AVL 樹
pub fn AVLTree(comptime T: type) type {
return struct {
const Self = @This();
root: ?*inc.TreeNode(T) = null, // 根節點
mem_arena: ?std.heap.ArenaAllocator = null,
mem_allocator: std.mem.Allocator = undefined, // 記憶體分配器
// 建構子
pub fn init(self: *Self, allocator: std.mem.Allocator) void {
if (self.mem_arena == null) {
self.mem_arena = std.heap.ArenaAllocator.init(allocator);
self.mem_allocator = self.mem_arena.?.allocator();
}
}
// 析構方法
pub fn deinit(self: *Self) void {
if (self.mem_arena == null) return;
self.mem_arena.?.deinit();
}
// 獲取節點高度
fn height(self: *Self, node: ?*inc.TreeNode(T)) i32 {
_ = self;
// 空節點高度為 -1 ,葉節點高度為 0
return if (node == null) -1 else node.?.height;
}
// 更新節點高度
fn updateHeight(self: *Self, node: ?*inc.TreeNode(T)) void {
// 節點高度等於最高子樹高度 + 1
node.?.height = @max(self.height(node.?.left), self.height(node.?.right)) + 1;
}
// 獲取平衡因子
fn balanceFactor(self: *Self, node: ?*inc.TreeNode(T)) i32 {
// 空節點平衡因子為 0
if (node == null) return 0;
// 節點平衡因子 = 左子樹高度 - 右子樹高度
return self.height(node.?.left) - self.height(node.?.right);
}
// 右旋操作
fn rightRotate(self: *Self, node: ?*inc.TreeNode(T)) ?*inc.TreeNode(T) {
var child = node.?.left;
var grandChild = child.?.right;
// 以 child 為原點,將 node 向右旋轉
child.?.right = node;
node.?.left = grandChild;
// 更新節點高度
self.updateHeight(node);
self.updateHeight(child);
// 返回旋轉後子樹的根節點
return child;
}
// 左旋操作
fn leftRotate(self: *Self, node: ?*inc.TreeNode(T)) ?*inc.TreeNode(T) {
var child = node.?.right;
var grandChild = child.?.left;
// 以 child 為原點,將 node 向左旋轉
child.?.left = node;
node.?.right = grandChild;
// 更新節點高度
self.updateHeight(node);
self.updateHeight(child);
// 返回旋轉後子樹的根節點
return child;
}
// 執行旋轉操作,使該子樹重新恢復平衡
fn rotate(self: *Self, node: ?*inc.TreeNode(T)) ?*inc.TreeNode(T) {
// 獲取節點 node 的平衡因子
var balance_factor = self.balanceFactor(node);
// 左偏樹
if (balance_factor > 1) {
if (self.balanceFactor(node.?.left) >= 0) {
// 右旋
return self.rightRotate(node);
} else {
// 先左旋後右旋
node.?.left = self.leftRotate(node.?.left);
return self.rightRotate(node);
}
}
// 右偏樹
if (balance_factor < -1) {
if (self.balanceFactor(node.?.right) <= 0) {
// 左旋
return self.leftRotate(node);
} else {
// 先右旋後左旋
node.?.right = self.rightRotate(node.?.right);
return self.leftRotate(node);
}
}
// 平衡樹,無須旋轉,直接返回
return node;
}
// 插入節點
fn insert(self: *Self, val: T) !void {
self.root = (try self.insertHelper(self.root, val)).?;
}
// 遞迴插入節點(輔助方法)
fn insertHelper(self: *Self, node_: ?*inc.TreeNode(T), val: T) !?*inc.TreeNode(T) {
var node = node_;
if (node == null) {
var tmp_node = try self.mem_allocator.create(inc.TreeNode(T));
tmp_node.init(val);
return tmp_node;
}
// 1. 查詢插入位置並插入節點
if (val < node.?.val) {
node.?.left = try self.insertHelper(node.?.left, val);
} else if (val > node.?.val) {
node.?.right = try self.insertHelper(node.?.right, val);
} else {
return node; // 重複節點不插入,直接返回
}
self.updateHeight(node); // 更新節點高度
// 2. 執行旋轉操作,使該子樹重新恢復平衡
node = self.rotate(node);
// 返回子樹的根節點
return node;
}
// 刪除節點
fn remove(self: *Self, val: T) void {
self.root = self.removeHelper(self.root, val).?;
}
// 遞迴刪除節點(輔助方法)
fn removeHelper(self: *Self, node_: ?*inc.TreeNode(T), val: T) ?*inc.TreeNode(T) {
var node = node_;
if (node == null) return null;
// 1. 查詢節點並刪除
if (val < node.?.val) {
node.?.left = self.removeHelper(node.?.left, val);
} else if (val > node.?.val) {
node.?.right = self.removeHelper(node.?.right, val);
} else {
if (node.?.left == null or node.?.right == null) {
var child = if (node.?.left != null) node.?.left else node.?.right;
// 子節點數量 = 0 ,直接刪除 node 並返回
if (child == null) {
return null;
// 子節點數量 = 1 ,直接刪除 node
} else {
node = child;
}
} else {
// 子節點數量 = 2 ,則將中序走訪的下個節點刪除,並用該節點替換當前節點
var temp = node.?.right;
while (temp.?.left != null) {
temp = temp.?.left;
}
node.?.right = self.removeHelper(node.?.right, temp.?.val);
node.?.val = temp.?.val;
}
}
self.updateHeight(node); // 更新節點高度
// 2. 執行旋轉操作,使該子樹重新恢復平衡
node = self.rotate(node);
// 返回子樹的根節點
return node;
}
// 查詢節點
fn search(self: *Self, val: T) ?*inc.TreeNode(T) {
var cur = self.root;
// 迴圈查詢,越過葉節點後跳出
while (cur != null) {
// 目標節點在 cur 的右子樹中
if (cur.?.val < val) {
cur = cur.?.right;
// 目標節點在 cur 的左子樹中
} else if (cur.?.val > val) {
cur = cur.?.left;
// 找到目標節點,跳出迴圈
} else {
break;
}
}
// 返回目標節點
return cur;
}
};
}
pub fn testInsert(comptime T: type, tree_: *AVLTree(T), val: T) !void {
var tree = tree_;
try tree.insert(val);
std.debug.print("\n插入節點 {} 後,AVL 樹為\n", .{val});
try inc.PrintUtil.printTree(tree.root, null, false);
}
pub fn testRemove(comptime T: type, tree_: *AVLTree(T), val: T) void {
var tree = tree_;
tree.remove(val);
std.debug.print("\n刪除節點 {} 後,AVL 樹為\n", .{val});
try inc.PrintUtil.printTree(tree.root, null, false);
}
// Driver Code
pub fn main() !void {
// 初始化空 AVL 樹
var avl_tree = AVLTree(i32){};
avl_tree.init(std.heap.page_allocator);
defer avl_tree.deinit();
// 插入節點
// 請關注插入節點後,AVL 樹是如何保持平衡的
try testInsert(i32, &avl_tree, 1);
try testInsert(i32, &avl_tree, 2);
try testInsert(i32, &avl_tree, 3);
try testInsert(i32, &avl_tree, 4);
try testInsert(i32, &avl_tree, 5);
try testInsert(i32, &avl_tree, 8);
try testInsert(i32, &avl_tree, 7);
try testInsert(i32, &avl_tree, 9);
try testInsert(i32, &avl_tree, 10);
try testInsert(i32, &avl_tree, 6);
// 插入重複節點
try testInsert(i32, &avl_tree, 7);
// 刪除節點
// 請關注刪除節點後,AVL 樹是如何保持平衡的
testRemove(i32, &avl_tree, 8); // 刪除度為 0 的節點
testRemove(i32, &avl_tree, 5); // 刪除度為 1 的節點
testRemove(i32, &avl_tree, 4); // 刪除度為 2 的節點
// 查詢節點
var node = avl_tree.search(7).?;
std.debug.print("\n查詢到的節點物件為 {any},節點值 = {}\n", .{node, node.val});
_ = try std.io.getStdIn().reader().readByte();
}
@@ -0,0 +1,182 @@
// File: binary_search_tree.zig
// Created Time: 2023-01-15
// Author: codingonion (coderonion@gmail.com)
const std = @import("std");
const inc = @import("include");
// 二元搜尋樹
pub fn BinarySearchTree(comptime T: type) type {
return struct {
const Self = @This();
root: ?*inc.TreeNode(T) = null,
mem_arena: ?std.heap.ArenaAllocator = null,
mem_allocator: std.mem.Allocator = undefined, // 記憶體分配器
// 建構子
pub fn init(self: *Self, allocator: std.mem.Allocator, nums: []T) !void {
if (self.mem_arena == null) {
self.mem_arena = std.heap.ArenaAllocator.init(allocator);
self.mem_allocator = self.mem_arena.?.allocator();
}
std.mem.sort(T, nums, {}, comptime std.sort.asc(T)); // 排序陣列
self.root = try self.buildTree(nums, 0, nums.len - 1); // 構建二元搜尋樹
}
// 析構方法
pub fn deinit(self: *Self) void {
if (self.mem_arena == null) return;
self.mem_arena.?.deinit();
}
// 構建二元搜尋樹
fn buildTree(self: *Self, nums: []T, i: usize, j: usize) !?*inc.TreeNode(T) {
if (i > j) return null;
// 將陣列中間節點作為根節點
var mid = (i + j) / 2;
var node = try self.mem_allocator.create(inc.TreeNode(T));
node.init(nums[mid]);
// 遞迴建立左子樹和右子樹
if (mid >= 1) node.left = try self.buildTree(nums, i, mid - 1);
node.right = try self.buildTree(nums, mid + 1, j);
return node;
}
// 獲取二元樹根節點
fn getRoot(self: *Self) ?*inc.TreeNode(T) {
return self.root;
}
// 查詢節點
fn search(self: *Self, num: T) ?*inc.TreeNode(T) {
var cur = self.root;
// 迴圈查詢,越過葉節點後跳出
while (cur != null) {
// 目標節點在 cur 的右子樹中
if (cur.?.val < num) {
cur = cur.?.right;
// 目標節點在 cur 的左子樹中
} else if (cur.?.val > num) {
cur = cur.?.left;
// 找到目標節點,跳出迴圈
} else {
break;
}
}
// 返回目標節點
return cur;
}
// 插入節點
fn insert(self: *Self, num: T) !void {
// 若樹為空,則初始化根節點
if (self.root == null) {
self.root = try self.mem_allocator.create(inc.TreeNode(T));
return;
}
var cur = self.root;
var pre: ?*inc.TreeNode(T) = null;
// 迴圈查詢,越過葉節點後跳出
while (cur != null) {
// 找到重複節點,直接返回
if (cur.?.val == num) return;
pre = cur;
// 插入位置在 cur 的右子樹中
if (cur.?.val < num) {
cur = cur.?.right;
// 插入位置在 cur 的左子樹中
} else {
cur = cur.?.left;
}
}
// 插入節點
var node = try self.mem_allocator.create(inc.TreeNode(T));
node.init(num);
if (pre.?.val < num) {
pre.?.right = node;
} else {
pre.?.left = node;
}
}
// 刪除節點
fn remove(self: *Self, num: T) void {
// 若樹為空,直接提前返回
if (self.root == null) return;
var cur = self.root;
var pre: ?*inc.TreeNode(T) = null;
// 迴圈查詢,越過葉節點後跳出
while (cur != null) {
// 找到待刪除節點,跳出迴圈
if (cur.?.val == num) break;
pre = cur;
// 待刪除節點在 cur 的右子樹中
if (cur.?.val < num) {
cur = cur.?.right;
// 待刪除節點在 cur 的左子樹中
} else {
cur = cur.?.left;
}
}
// 若無待刪除節點,則直接返回
if (cur == null) return;
// 子節點數量 = 0 or 1
if (cur.?.left == null or cur.?.right == null) {
// 當子節點數量 = 0 / 1 時, child = null / 該子節點
var child = if (cur.?.left != null) cur.?.left else cur.?.right;
// 刪除節點 cur
if (pre.?.left == cur) {
pre.?.left = child;
} else {
pre.?.right = child;
}
// 子節點數量 = 2
} else {
// 獲取中序走訪中 cur 的下一個節點
var tmp = cur.?.right;
while (tmp.?.left != null) {
tmp = tmp.?.left;
}
var tmp_val = tmp.?.val;
// 遞迴刪除節點 tmp
self.remove(tmp.?.val);
// 用 tmp 覆蓋 cur
cur.?.val = tmp_val;
}
}
};
}
// Driver Code
pub fn main() !void {
// 初始化二元樹
var nums = [_]i32{ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 };
var bst = BinarySearchTree(i32){};
try bst.init(std.heap.page_allocator, &nums);
defer bst.deinit();
std.debug.print("初始化的二元樹為\n", .{});
try inc.PrintUtil.printTree(bst.getRoot(), null, false);
// 查詢節點
var node = bst.search(7);
std.debug.print("\n查詢到的節點物件為 {any},節點值 = {}\n", .{node, node.?.val});
// 插入節點
try bst.insert(16);
std.debug.print("\n插入節點 16 後,二元樹為\n", .{});
try inc.PrintUtil.printTree(bst.getRoot(), null, false);
// 刪除節點
bst.remove(1);
std.debug.print("\n刪除節點 1 後,二元樹為\n", .{});
try inc.PrintUtil.printTree(bst.getRoot(), null, false);
bst.remove(2);
std.debug.print("\n刪除節點 2 後,二元樹為\n", .{});
try inc.PrintUtil.printTree(bst.getRoot(), null, false);
bst.remove(4);
std.debug.print("\n刪除節點 4 後,二元樹為\n", .{});
try inc.PrintUtil.printTree(bst.getRoot(), null, false);
_ = try std.io.getStdIn().reader().readByte();
}
@@ -0,0 +1,39 @@
// File: binary_tree.zig
// Created Time: 2023-01-14
// Author: codingonion (coderonion@gmail.com)
const std = @import("std");
const inc = @import("include");
// Driver Code
pub fn main() !void {
// 初始化二元樹
// 初始化節點
var n1 = inc.TreeNode(i32){ .val = 1 };
var n2 = inc.TreeNode(i32){ .val = 2 };
var n3 = inc.TreeNode(i32){ .val = 3 };
var n4 = inc.TreeNode(i32){ .val = 4 };
var n5 = inc.TreeNode(i32){ .val = 5 };
// 構建節點之間的引用(指標)
n1.left = &n2;
n1.right = &n3;
n2.left = &n4;
n2.right = &n5;
std.debug.print("初始化二元樹\n", .{});
try inc.PrintUtil.printTree(&n1, null, false);
// 插入與刪除節點
var p = inc.TreeNode(i32){ .val = 0 };
// 在 n1 -> n2 中間插入節點 P
n1.left = &p;
p.left = &n2;
std.debug.print("插入節點 P 後\n", .{});
try inc.PrintUtil.printTree(&n1, null, false);
// 刪除節點
n1.left = &n2;
std.debug.print("刪除節點 P 後\n", .{});
try inc.PrintUtil.printTree(&n1, null, false);
_ = try std.io.getStdIn().reader().readByte();
}
@@ -0,0 +1,57 @@
// File: binary_tree_bfs.zig
// Created Time: 2023-01-15
// Author: codingonion (coderonion@gmail.com)
const std = @import("std");
const inc = @import("include");
// 層序走訪
fn levelOrder(comptime T: type, mem_allocator: std.mem.Allocator, root: *inc.TreeNode(T)) !std.ArrayList(T) {
// 初始化佇列,加入根節點
const L = std.TailQueue(*inc.TreeNode(T));
var queue = L{};
var root_node = try mem_allocator.create(L.Node);
root_node.data = root;
queue.append(root_node);
// 初始化一個串列,用於儲存走訪序列
var list = std.ArrayList(T).init(std.heap.page_allocator);
while (queue.len > 0) {
var queue_node = queue.popFirst().?; // 隊列出隊
var node = queue_node.data;
try list.append(node.val); // 儲存節點值
if (node.left != null) {
var tmp_node = try mem_allocator.create(L.Node);
tmp_node.data = node.left.?;
queue.append(tmp_node); // 左子節點入列
}
if (node.right != null) {
var tmp_node = try mem_allocator.create(L.Node);
tmp_node.data = node.right.?;
queue.append(tmp_node); // 右子節點入列
}
}
return list;
}
// Driver Code
pub fn main() !void {
// 初始化記憶體分配器
var mem_arena = std.heap.ArenaAllocator.init(std.heap.page_allocator);
defer mem_arena.deinit();
const mem_allocator = mem_arena.allocator();
// 初始化二元樹
// 這裡藉助了一個從陣列直接生成二元樹的函式
var nums = [_]i32{1, 2, 3, 4, 5, 6, 7};
var root = try inc.TreeUtil.arrToTree(i32, mem_allocator, &nums);
std.debug.print("初始化二元樹\n", .{});
try inc.PrintUtil.printTree(root, null, false);
// 層序走訪
var list = try levelOrder(i32, mem_allocator, root.?);
defer list.deinit();
std.debug.print("\n層序走訪的節點列印序列 = ", .{});
inc.PrintUtil.printList(i32, list);
_ = try std.io.getStdIn().reader().readByte();
}
@@ -0,0 +1,70 @@
// File: binary_tree_dfs.zig
// Created Time: 2023-01-15
// Author: codingonion (coderonion@gmail.com)
const std = @import("std");
const inc = @import("include");
var list = std.ArrayList(i32).init(std.heap.page_allocator);
// 前序走訪
fn preOrder(comptime T: type, root: ?*inc.TreeNode(T)) !void {
if (root == null) return;
// 訪問優先順序:根節點 -> 左子樹 -> 右子樹
try list.append(root.?.val);
try preOrder(T, root.?.left);
try preOrder(T, root.?.right);
}
// 中序走訪
fn inOrder(comptime T: type, root: ?*inc.TreeNode(T)) !void {
if (root == null) return;
// 訪問優先順序:左子樹 -> 根節點 -> 右子樹
try inOrder(T, root.?.left);
try list.append(root.?.val);
try inOrder(T, root.?.right);
}
// 後序走訪
fn postOrder(comptime T: type, root: ?*inc.TreeNode(T)) !void {
if (root == null) return;
// 訪問優先順序:左子樹 -> 右子樹 -> 根節點
try postOrder(T, root.?.left);
try postOrder(T, root.?.right);
try list.append(root.?.val);
}
// Driver Code
pub fn main() !void {
// 初始化記憶體分配器
var mem_arena = std.heap.ArenaAllocator.init(std.heap.page_allocator);
defer mem_arena.deinit();
const mem_allocator = mem_arena.allocator();
// 初始化二元樹
// 這裡藉助了一個從陣列直接生成二元樹的函式
var nums = [_]i32{1, 2, 3, 4, 5, 6, 7};
var root = try inc.TreeUtil.arrToTree(i32, mem_allocator, &nums);
std.debug.print("初始化二元樹\n", .{});
try inc.PrintUtil.printTree(root, null, false);
// 前序走訪
list.clearRetainingCapacity();
try preOrder(i32, root);
std.debug.print("\n前序走訪的節點列印序列 = ", .{});
inc.PrintUtil.printList(i32, list);
// 中序走訪
list.clearRetainingCapacity();
try inOrder(i32, root);
std.debug.print("\n中序走訪的節點列印序列 = ", .{});
inc.PrintUtil.printList(i32, list);
// 後序走訪
list.clearRetainingCapacity();
try postOrder(i32, root);
std.debug.print("\n後續走訪的節點列印序列 = ", .{});
inc.PrintUtil.printList(i32, list);
_ = try std.io.getStdIn().reader().readByte();
}