Re-translate the Japanese version (#1871)

* Retranslate Japanese docs with GPT-5.4 * Retranslate Japanese code with GPT-5.4
2026-07-23 03:46:05 +00:00 · 2026-03-30 07:30:15 +08:00
parent fe6443235b
commit d7b2277d2b
1444 changed files with 83312 additions and 8363 deletions
@@ -0,0 +1,64 @@
+// File: binary_search.zig
+// Created Time: 2023-01-15
+// Author: codingonion (coderonion@gmail.com)
+
+const std = @import("std");
+const inc = @import("include");
+
+// 二分探索（両閉区間）
+fn binarySearch(comptime T: type, nums: std.ArrayList(T), target: T) T {
+    // 両閉区間 [0, n-1] を初期化する。つまり i, j はそれぞれ配列の先頭要素と末尾要素を指す
+    var i: usize = 0;
+    var j: usize = nums.items.len - 1;
+    // ループし、探索区間が空になったら終了する（i > j で空）
+    while (i <= j) {
+        var m = i + (j - i) / 2;                // 中点インデックス m を計算
+        if (nums.items[m] < target) {           // この場合、target は区間 [m+1, j] にある
+            i = m + 1;
+        } else if (nums.items[m] > target) {    // この場合、target は区間 [i, m-1] にある
+            j = m - 1;
+        } else {                                // 目標要素が見つかったらそのインデックスを返す
+            return @intCast(m);
+        }
+    }
+    // 目標要素が見つからなければ -1 を返す
+    return -1;
+}
+
+// 二分探索（左閉右開区間）
+fn binarySearchLCRO(comptime T: type, nums: std.ArrayList(T), target: T) T {
+    // 左閉右開区間 [0, n) を初期化する。つまり i, j はそれぞれ配列の先頭要素と末尾要素+1を指す
+    var i: usize = 0;
+    var j: usize = nums.items.len;
+    // ループし、探索区間が空になったら終了する（i = j で空）
+    while (i <= j) {
+        var m = i + (j - i) / 2;                // 中点インデックス m を計算
+        if (nums.items[m] < target) {           // この場合、target は区間 [m+1, j) にある
+            i = m + 1;
+        } else if (nums.items[m] > target) {    // この場合、target は区間 [i, m) にある
+            j = m;
+        } else {                                // 目標要素が見つかったらそのインデックスを返す
+            return @intCast(m);
+        }
+    }
+    // 目標要素が見つからなければ -1 を返す
+    return -1;
+}
+
+// Driver Code
+pub fn main() !void {
+    var target: i32 = 6;
+    var nums = std.ArrayList(i32).init(std.heap.page_allocator);
+    defer nums.deinit();
+    try nums.appendSlice(&[_]i32{ 1, 3, 6, 8, 12, 15, 23, 26, 31, 35 });
+
+    // 二分探索（両閉区間）
+    var index = binarySearch(i32, nums, target);
+    std.debug.print("対象要素 6 のインデックス = {}\n", .{index});
+
+    // 二分探索（左閉右開区間）
+    index = binarySearchLCRO(i32, nums, target);
+    std.debug.print("対象要素 6 のインデックス = {}\n", .{index});
+
+    _ = try std.io.getStdIn().reader().readByte();
+}
@@ -0,0 +1,57 @@
+// File: hashing_search.zig
+// Created Time: 2023-01-15
+// Author: codingonion (coderonion@gmail.com)
+
+const std = @import("std");
+const inc = @import("include");
+
+// ハッシュ探索（配列）
+fn hashingSearchArray(comptime T: type, map: std.AutoHashMap(T, T), target: T) T {
+    // ハッシュテーブルの key: 目標要素、value: インデックス
+    // ハッシュテーブルにこの key がなければ -1 を返す
+    if (map.getKey(target) == null) return -1;
+    return map.get(target).?;
+}
+
+// ハッシュ探索（連結リスト）
+fn hashingSearchLinkedList(comptime T: type, map: std.AutoHashMap(T, *inc.ListNode(T)), target: T) ?*inc.ListNode(T) {
+    // ハッシュテーブルの key: 目標ノード値、value: ノードオブジェクト
+    // ハッシュテーブルにこの key がなければ null を返す
+    if (map.getKey(target) == null) return null;
+    return map.get(target);
+}
+
+// Driver Code
+pub fn main() !void {
+    var target: i32 = 3;
+
+    // ハッシュ探索（配列）
+    var nums = [_]i32{ 1, 5, 3, 2, 4, 7, 5, 9, 10, 8 };
+    // ハッシュテーブルを初期化
+    var map = std.AutoHashMap(i32, i32).init(std.heap.page_allocator);
+    defer map.deinit();
+    for (nums, 0..) |num, i| {
+        try map.put(num, @as(i32, @intCast(i)));    // key: 要素、value: インデックス
+    }
+    var index = hashingSearchArray(i32, map, target);
+    std.debug.print("対象要素 3 のインデックス = {}\n", .{index});
+
+    // ハッシュ探索（連結リスト）
+    var mem_arena = std.heap.ArenaAllocator.init(std.heap.page_allocator);
+    defer mem_arena.deinit();
+    const mem_allocator = mem_arena.allocator();
+    var head = try inc.ListUtil.arrToLinkedList(i32, mem_allocator, &nums);
+    // ハッシュテーブルを初期化
+    var map1 = std.AutoHashMap(i32, *inc.ListNode(i32)).init(std.heap.page_allocator);
+    defer map1.deinit();
+    while (head != null) {
+        try map1.put(head.?.val, head.?);
+        head = head.?.next;
+    }
+    var node = hashingSearchLinkedList(i32, map1, target);
+    std.debug.print("対象ノード値 3 に対応するノードオブジェクトは ", .{});
+    try inc.PrintUtil.printLinkedList(i32, node);
+
+    _ = try std.io.getStdIn().reader().readByte();
+}
+
@@ -0,0 +1,54 @@
+// File: linear_search.zig
+// Created Time: 2023-01-13
+// Author: codingonion (coderonion@gmail.com)
+
+const std = @import("std");
+const inc = @import("include");
+
+// 線形探索（配列）
+fn linearSearchArray(comptime T: type, nums: std.ArrayList(T), target: T) T {
+    // 配列を走査
+    for (nums.items, 0..) |num, i| {
+        // 対象要素が見つかったら、その添字を返す
+        if (num == target) {
+            return @intCast(i);
+        }
+    }
+    // 目標要素が見つからなければ -1 を返す
+    return -1;
+}
+
+// 線形探索（連結リスト）
+pub fn linearSearchLinkedList(comptime T: type, node: ?*inc.ListNode(T), target: T) ?*inc.ListNode(T) {
+    var head = node;
+    // 連結リストを走査
+    while (head != null) {
+        // 対象ノードが見つかったら、それを返す
+        if (head.?.val == target) return head;
+        head = head.?.next;
+    }
+    return null;
+}
+
+// Driver Code
+pub fn main() !void {
+    var target: i32 = 3;
+
+    // 配列で線形探索を行う
+    var nums = std.ArrayList(i32).init(std.heap.page_allocator);
+    defer nums.deinit();
+    try nums.appendSlice(&[_]i32{ 1, 5, 3, 2, 4, 7, 5, 9, 10, 8 });
+    var index = linearSearchArray(i32, nums, target);
+    std.debug.print("対象要素 3 のインデックス = {}\n", .{index});
+
+    // 連結リストで線形探索を行う
+    var mem_arena = std.heap.ArenaAllocator.init(std.heap.page_allocator);
+    defer mem_arena.deinit();
+    const mem_allocator = mem_arena.allocator();
+    var head = try inc.ListUtil.listToLinkedList(i32, mem_allocator, nums);
+    var node = linearSearchLinkedList(i32, head, target);
+    std.debug.print("対象ノード値 3 に対応するノードオブジェクトは ", .{});
+    try inc.PrintUtil.printLinkedList(i32, node);
+
+    _ = try std.io.getStdIn().reader().readByte();
+}
@@ -0,0 +1,58 @@
+// File: two_sum.zig
+// Created Time: 2023-01-07
+// Author: codingonion (coderonion@gmail.com)
+
+const std = @import("std");
+const inc = @import("include");
+
+// 方法 1：総当たり列挙
+pub fn twoSumBruteForce(nums: []i32, target: i32) ?[2]i32 {
+    var size: usize = nums.len;
+    var i: usize = 0;
+    // 2重ループのため、時間計算量は O(n^2)
+    while (i < size - 1) : (i += 1) {
+        var j = i + 1;
+        while (j < size) : (j += 1) {
+            if (nums[i] + nums[j] == target) {
+                return [_]i32{@intCast(i), @intCast(j)};
+            }
+        }
+    }
+    return null;
+}
+
+// 方法 2：補助ハッシュテーブル
+pub fn twoSumHashTable(nums: []i32, target: i32) !?[2]i32 {
+    var size: usize = nums.len;
+    // 補助ハッシュテーブルを使用し、空間計算量は O(n)
+    var dic = std.AutoHashMap(i32, i32).init(std.heap.page_allocator);
+    defer dic.deinit();
+    var i: usize = 0;
+    // 単一ループで、時間計算量は O(n)
+    while (i < size) : (i += 1) {
+        if (dic.contains(target - nums[i])) {
+            return [_]i32{dic.get(target - nums[i]).?, @intCast(i)};
+        }
+        try dic.put(nums[i], @intCast(i));
+    }
+    return null;
+}
+
+
+pub fn main() !void {
+    // ======= Test Case =======
+    var nums = [_]i32{ 2, 7, 11, 15 };
+    var target: i32 = 9;
+
+    // ====== Driver Code ======
+    // 方法 1
+    var res = twoSumBruteForce(&nums, target).?;
+    std.debug.print("方法1 res = ", .{});
+    inc.PrintUtil.printArray(i32, &res); 
+    // 方法 2
+    res = (try twoSumHashTable(&nums, target)).?;
+    std.debug.print("\n方法2 res = ", .{});
+    inc.PrintUtil.printArray(i32, &res); 
+
+    _ = try std.io.getStdIn().reader().readByte();
+}