Re-translate the Japanese version (#1871)

* Retranslate Japanese docs with GPT-5.4 * Retranslate Japanese code with GPT-5.4
2026-07-14 16:16:06 +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: heap.cs
+ * Created Time: 2023-02-06
+ * Author: zjkung1123 (zjkung1123@gmail.com)
+ */
+
+namespace hello_algo.chapter_heap;
+
+public class heap {
+    void TestPush(PriorityQueue<int, int> heap, int val) {
+        heap.Enqueue(val, val); // 要素をヒープに追加
+        Console.WriteLine($"\n要素 {val} をヒープに追加した後\n");
+        PrintUtil.PrintHeap(heap);
+    }
+
+    void TestPop(PriorityQueue<int, int> heap) {
+        int val = heap.Dequeue(); // ヒープ頂点の要素を取り出す
+        Console.WriteLine($"\nヒープの先頭要素 {val} を取り出した後\n");
+        PrintUtil.PrintHeap(heap);
+    }
+
+    [Test]
+    public void Test() {
+        /* ヒープを初期化 */
+        // 最小ヒープを初期化
+        PriorityQueue<int, int> minHeap = new();
+        // 最大ヒープを初期化する（Comparer はラムダ式で変更できる）
+        PriorityQueue<int, int> maxHeap = new(Comparer<int>.Create((x, y) => y.CompareTo(x)));
+        Console.WriteLine("以下のテストケースは最大ヒープです");
+
+        /* 要素をヒープに追加 */
+        TestPush(maxHeap, 1);
+        TestPush(maxHeap, 3);
+        TestPush(maxHeap, 2);
+        TestPush(maxHeap, 5);
+        TestPush(maxHeap, 4);
+
+        /* ヒープ頂点の要素を取得 */
+        int peek = maxHeap.Peek();
+        Console.WriteLine($"ヒープの先頭要素は {peek}");
+
+        /* ヒープ頂点の要素を取り出す */
+        // ヒープから取り出した要素は大きい順に並ぶ
+        TestPop(maxHeap);
+        TestPop(maxHeap);
+        TestPop(maxHeap);
+        TestPop(maxHeap);
+        TestPop(maxHeap);
+
+        /* ヒープのサイズを取得 */
+        int size = maxHeap.Count;
+        Console.WriteLine($"ヒープの要素数は {size}");
+
+        /* ヒープが空かどうかを判定 */
+        bool isEmpty = maxHeap.Count == 0;
+        Console.WriteLine($"ヒープは空か {isEmpty}");
+
+        /* リストを入力してヒープを構築 */
+        var list = new int[] { 1, 3, 2, 5, 4 };
+        minHeap = new PriorityQueue<int, int>(list.Select(x => (x, x)));
+        Console.WriteLine("リストを入力して最小ヒープを構築した後");
+        PrintUtil.PrintHeap(minHeap);
+    }
+}
@@ -0,0 +1,160 @@
+/**
+ * File: my_heap.cs
+ * Created Time: 2023-02-06
+ * Author: zjkung1123 (zjkung1123@gmail.com)
+ */
+
+namespace hello_algo.chapter_heap;
+
+/* 最大ヒープ */
+class MaxHeap {
+    // 配列ではなくリストを使うことで、拡張を考慮する必要がない
+    List<int> maxHeap;
+
+    /* コンストラクタ。空のヒープを作成する */
+    public MaxHeap() {
+        maxHeap = [];
+    }
+
+    /* コンストラクタ。入力リストに基づいてヒープを構築 */
+    public MaxHeap(IEnumerable<int> nums) {
+        // リスト要素をそのままヒープに追加
+        maxHeap = new List<int>(nums);
+        // 葉ノード以外のすべてのノードをヒープ化
+        var size = Parent(this.Size() - 1);
+        for (int i = size; i >= 0; i--) {
+            SiftDown(i);
+        }
+    }
+
+    /* 左子ノードのインデックスを取得 */
+    int Left(int i) {
+        return 2 * i + 1;
+    }
+
+    /* 右子ノードのインデックスを取得 */
+    int Right(int i) {
+        return 2 * i + 2;
+    }
+
+    /* 親ノードのインデックスを取得 */
+    int Parent(int i) {
+        return (i - 1) / 2; // 切り捨て除算
+    }
+
+    /* ヒープ先頭要素にアクセス */
+    public int Peek() {
+        return maxHeap[0];
+    }
+
+    /* 要素をヒープに追加 */
+    public void Push(int val) {
+        // ノードを追加
+        maxHeap.Add(val);
+        // 下から上へヒープ化
+        SiftUp(Size() - 1);
+    }
+
+    /* ヒープのサイズを取得 */
+    public int Size() {
+        return maxHeap.Count;
+    }
+
+    /* ヒープが空かどうかを判定 */
+    public bool IsEmpty() {
+        return Size() == 0;
+    }
+
+    /* ノード i から始めて、下から上へヒープ化 */
+    void SiftUp(int i) {
+        while (true) {
+            // ノード i の親ノードを取得
+            int p = Parent(i);
+            // 「根ノードを越えた」または「ノードの修復が不要」な場合は、ヒープ化を終了する
+            if (p < 0 || maxHeap[i] <= maxHeap[p])
+                break;
+            // 2 つのノードを交換
+            Swap(i, p);
+            // ループで下から上へヒープ化
+            i = p;
+        }
+    }
+
+    /* 要素をヒープから取り出す */
+    public int Pop() {
+        // 空判定の処理
+        if (IsEmpty())
+            throw new IndexOutOfRangeException();
+        // 根ノードと最も右の葉ノードを交換（先頭要素と末尾要素を交換）
+        Swap(0, Size() - 1);
+        // ノードを削除
+        int val = maxHeap.Last();
+        maxHeap.RemoveAt(Size() - 1);
+        // 上から下へヒープ化
+        SiftDown(0);
+        // ヒープ先頭要素を返す
+        return val;
+    }
+
+    /* ノード i から始めて、上から下へヒープ化 */
+    void SiftDown(int i) {
+        while (true) {
+            // ノード i, l, r のうち値が最大のノードを ma とする
+            int l = Left(i), r = Right(i), ma = i;
+            if (l < Size() && maxHeap[l] > maxHeap[ma])
+                ma = l;
+            if (r < Size() && maxHeap[r] > maxHeap[ma])
+                ma = r;
+            // 「ノード i が最大」または「葉ノードを越えた」場合は、ヒープ化を終了する
+            if (ma == i) break;
+            // 2 つのノードを交換
+            Swap(i, ma);
+            // ループで上から下へヒープ化
+            i = ma;
+        }
+    }
+
+    /* 要素を交換 */
+    void Swap(int i, int p) {
+        (maxHeap[i], maxHeap[p]) = (maxHeap[p], maxHeap[i]);
+    }
+
+    /* ヒープ（二分木）を出力 */
+    public void Print() {
+        var queue = new Queue<int>(maxHeap);
+        PrintUtil.PrintHeap(queue);
+    }
+}
+
+public class my_heap {
+    [Test]
+    public void Test() {
+        /* 最大ヒープを初期化 */
+        MaxHeap maxHeap = new([9, 8, 6, 6, 7, 5, 2, 1, 4, 3, 6, 2]);
+        Console.WriteLine("\nリストを入力してヒープを構築した後");
+        maxHeap.Print();
+
+        /* ヒープ頂点の要素を取得 */
+        int peek = maxHeap.Peek();
+        Console.WriteLine($"ヒープの先頭要素は {peek}");
+
+        /* 要素をヒープに追加 */
+        int val = 7;
+        maxHeap.Push(val);
+        Console.WriteLine($"要素 {val} をヒープに追加した後");
+        maxHeap.Print();
+
+        /* ヒープ頂点の要素を取り出す */
+        peek = maxHeap.Pop();
+        Console.WriteLine($"ヒープの先頭要素 {peek} を取り出した後");
+        maxHeap.Print();
+
+        /* ヒープのサイズを取得 */
+        int size = maxHeap.Size();
+        Console.WriteLine($"ヒープの要素数は {size}");
+
+        /* ヒープが空かどうかを判定 */
+        bool isEmpty = maxHeap.IsEmpty();
+        Console.WriteLine($"ヒープは空か {isEmpty}");
+    }
+}
@@ -0,0 +1,37 @@
+/**
+* File: top_k.cs
+* Created Time: 2023-06-14
+* Author: hpstory (hpstory1024@163.com)
+*/
+
+namespace hello_algo.chapter_heap;
+
+public class top_k {
+    /* ヒープに基づいて配列中の最大の k 個の要素を探す */
+    PriorityQueue<int, int> TopKHeap(int[] nums, int k) {
+        // 最小ヒープを初期化
+        PriorityQueue<int, int> heap = new();
+        // 配列の先頭 k 個の要素をヒープに追加
+        for (int i = 0; i < k; i++) {
+            heap.Enqueue(nums[i], nums[i]);
+        }
+        // k+1 番目の要素から開始し、ヒープ長を k に保つ
+        for (int i = k; i < nums.Length; i++) {
+            // 現在の要素がヒープ先頭より大きければ、ヒープ先頭を取り出して現在の要素を追加する
+            if (nums[i] > heap.Peek()) {
+                heap.Dequeue();
+                heap.Enqueue(nums[i], nums[i]);
+            }
+        }
+        return heap;
+    }
+
+    [Test]
+    public void Test() {
+        int[] nums = [1, 7, 6, 3, 2];
+        int k = 3;
+        PriorityQueue<int, int> res = TopKHeap(nums, k);
+        Console.WriteLine("最大の " + k + " 個の要素は");
+        PrintUtil.PrintHeap(res);
+    }
+}