docs: add Japanese translate documents (#1812)

* docs: add Japanese documents (`ja/docs`) * docs: add Japanese documents (`ja/codes`) * docs: add Japanese documents * Remove pythontutor blocks in ja/ * Add an empty at the end of each markdown file. * Add the missing figures (use the English version temporarily). * Add index.md for Japanese version. * Add index.html for Japanese version. * Add missing index.assets * Fix backtracking_algorithm.md for Japanese version. * Add avatar_eltociear.jpg. Fix image links on the Japanese landing page. * Add the Japanese banner. --------- Co-authored-by: krahets <krahets@163.com>
2026-04-14 02:10:37 +08:00 · 2025-10-17 06:04:43 +09:00
parent 2487a27036
commit 954c45864b
886 changed files with 33569 additions and 0 deletions
--- a/ja/codes/java/chapter_heap/heap.java
+++ b/ja/codes/java/chapter_heap/heap.java
@@ -0,0 +1,66 @@
+/**
+ * File: heap.java
+ * Created Time: 2023-01-07
+ * Author: krahets (krahets@163.com)
+ */
+
+package chapter_heap;
+
+import utils.*;
+import java.util.*;
+
+public class heap {
+    public static void testPush(Queue<Integer> heap, int val) {
+        heap.offer(val); // 要素をヒープにプッシュ
+        System.out.format("\n要素 %d をヒープに追加後\n", val);
+        PrintUtil.printHeap(heap);
+    }
+
+    public static void testPop(Queue<Integer> heap) {
+        int val = heap.poll(); // ヒープの先頭要素をポップ
+        System.out.format("\n先頭要素 %d をヒープから削除後\n", val);
+        PrintUtil.printHeap(heap);
+    }
+
+    public static void main(String[] args) {
+        /* ヒープを初期化 */
+        // 最小ヒープを初期化
+        Queue<Integer> minHeap = new PriorityQueue<>();
+        // 最大ヒープを初期化（必要に応じてラムダ式を使用してComparatorを変更）
+        Queue<Integer> maxHeap = new PriorityQueue<>((a, b) -> b - a);
+
+        System.out.println("\n以下のテストケースは最大ヒープ用です");
+
+        /* 要素をヒープにプッシュ */
+        testPush(maxHeap, 1);
+        testPush(maxHeap, 3);
+        testPush(maxHeap, 2);
+        testPush(maxHeap, 5);
+        testPush(maxHeap, 4);
+
+        /* ヒープの先頭要素にアクセス */
+        int peek = maxHeap.peek();
+        System.out.format("\nヒープの先頭要素は %d\n", peek);
+
+        /* ヒープの先頭要素をポップ */
+        testPop(maxHeap);
+        testPop(maxHeap);
+        testPop(maxHeap);
+        testPop(maxHeap);
+        testPop(maxHeap);
+
+        /* ヒープのサイズを取得 */
+        int size = maxHeap.size();
+        System.out.format("\nヒープ内の要素数は %d\n", size);
+
+        /* ヒープが空かどうかを判定 */
+        boolean isEmpty = maxHeap.isEmpty();
+        System.out.format("\nヒープは空ですか %b\n", isEmpty);
+
+        /* リストを入力してヒープを構築 */
+        // 時間計算量は O(n)、O(nlogn) ではない
+        minHeap = new PriorityQueue<>(Arrays.asList(1, 3, 2, 5, 4));
+        System.out.println("\nリストを入力して最小ヒープを構築");
+        PrintUtil.printHeap(minHeap);
+    }
+}
--- a/ja/codes/java/chapter_heap/my_heap.java
+++ b/ja/codes/java/chapter_heap/my_heap.java
@@ -0,0 +1,159 @@
+/**
+ * File: my_heap.java
+ * Created Time: 2023-01-07
+ * Author: krahets (krahets@163.com)
+ */
+
+package chapter_heap;
+
+import utils.*;
+import java.util.*;
+
+/* 最大ヒープ */
+class MaxHeap {
+    // リサイズの必要性を避けるため、配列の代わりにリストを使用
+    private List<Integer> maxHeap;
+
+    /* コンストラクタ、入力リストに基づいてヒープを構築 */
+    public MaxHeap(List<Integer> nums) {
+        // すべてのリスト要素をヒープに追加
+        maxHeap = new ArrayList<>(nums);
+        // 葉を除くすべてのノードをヒープ化
+        for (int i = parent(size() - 1); i >= 0; i--) {
+            siftDown(i);
+        }
+    }
+
+    /* 左の子ノードのインデックスを取得 */
+    private int left(int i) {
+        return 2 * i + 1;
+    }
+
+    /* 右の子ノードのインデックスを取得 */
+    private int right(int i) {
+        return 2 * i + 2;
+    }
+
+    /* 親ノードのインデックスを取得 */
+    private int parent(int i) {
+        return (i - 1) / 2; // 整数除算で切り下げ
+    }
+
+    /* 要素を交換 */
+    private void swap(int i, int j) {
+        int tmp = maxHeap.get(i);
+        maxHeap.set(i, maxHeap.get(j));
+        maxHeap.set(j, tmp);
+    }
+
+    /* ヒープのサイズを取得 */
+    public int size() {
+        return maxHeap.size();
+    }
+
+    /* ヒープが空かどうかを判定 */
+    public boolean isEmpty() {
+        return size() == 0;
+    }
+
+    /* ヒープの先頭要素にアクセス */
+    public int peek() {
+        return maxHeap.get(0);
+    }
+
+    /* 要素をヒープにプッシュ */
+    public void push(int val) {
+        // ノードを追加
+        maxHeap.add(val);
+        // 下から上へヒープ化
+        siftUp(size() - 1);
+    }
+
+    /* ノード i から上向きにヒープ化を開始 */
+    private void siftUp(int i) {
+        while (true) {
+            // ノード i の親ノードを取得
+            int p = parent(i);
+            // 「根ノードを越える」または「ノードが修復不要」の場合、ヒープ化を終了
+            if (p < 0 || maxHeap.get(i) <= maxHeap.get(p))
+                break;
+            // 2つのノードを交換
+            swap(i, p);
+            // 上向きにヒープ化をループ
+            i = p;
+        }
+    }
+
+    /* 要素がヒープから退出 */
+    public int pop() {
+        // 空の処理
+        if (isEmpty())
+            throw new IndexOutOfBoundsException();
+        // 根ノードを最も右の葉ノードと交換（最初の要素を最後の要素と交換）
+        swap(0, size() - 1);
+        // ノードを削除
+        int val = maxHeap.remove(size() - 1);
+        // 上から下へヒープ化
+        siftDown(0);
+        // ヒープの先頭要素を返す
+        return val;
+    }
+
+    /* ノード i から下向きにヒープ化を開始 */
+    private void siftDown(int i) {
+        while (true) {
+            // i、l、r の中で最大のノードを決定し、ma とする
+            int l = left(i), r = right(i), ma = i;
+            if (l < size() && maxHeap.get(l) > maxHeap.get(ma))
+                ma = l;
+            if (r < size() && maxHeap.get(r) > maxHeap.get(ma))
+                ma = r;
+            // ノード i が最大の場合、またはインデックス l、r が範囲外の場合、さらなるヒープ化は不要、終了
+            if (ma == i)
+                break;
+            // 2つのノードを交換
+            swap(i, ma);
+            // 下向きにヒープ化をループ
+            i = ma;
+        }
+    }
+
+    /* ヒープ（二分木）を出力 */
+    public void print() {
+        Queue<Integer> queue = new PriorityQueue<>((a, b) -> { return b - a; });
+        queue.addAll(maxHeap);
+        PrintUtil.printHeap(queue);
+    }
+}
+
+public class my_heap {
+    public static void main(String[] args) {
+        /* 最大ヒープを初期化 */
+        MaxHeap maxHeap = new MaxHeap(Arrays.asList(9, 8, 6, 6, 7, 5, 2, 1, 4, 3, 6, 2));
+        System.out.println("\nリストを入力してヒープを構築");
+        maxHeap.print();
+
+        /* ヒープの先頭要素にアクセス */
+        int peek = maxHeap.peek();
+        System.out.format("\nヒープの先頭要素は %d\n", peek);
+
+        /* 要素をヒープにプッシュ */
+        int val = 7;
+        maxHeap.push(val);
+        System.out.format("\n要素 %d をヒープに追加後\n", val);
+        maxHeap.print();
+
+        /* ヒープの先頭要素をポップ */
+        peek = maxHeap.pop();
+        System.out.format("\n先頭要素 %d をヒープから削除後\n", peek);
+        maxHeap.print();
+
+        /* ヒープのサイズを取得 */
+        int size = maxHeap.size();
+        System.out.format("\nヒープ内の要素数は %d\n", size);
+
+        /* ヒープが空かどうかを判定 */
+        boolean isEmpty = maxHeap.isEmpty();
+        System.out.format("\nヒープは空ですか %b\n", isEmpty);
+    }
+}
--- a/ja/codes/java/chapter_heap/top_k.java
+++ b/ja/codes/java/chapter_heap/top_k.java
@@ -0,0 +1,40 @@
+/**
+ * File: top_k.java
+ * Created Time: 2023-06-12
+ * Author: krahets (krahets@163.com)
+ */
+
+package chapter_heap;
+
+import utils.*;
+import java.util.*;
+
+public class top_k {
+    /* ヒープを使用して配列内の最大 k 個の要素を検索 */
+    static Queue<Integer> topKHeap(int[] nums, int k) {
+        // 最小ヒープを初期化
+        Queue<Integer> heap = new PriorityQueue<Integer>();
+        // 配列の最初の k 個の要素をヒープに入力
+        for (int i = 0; i < k; i++) {
+            heap.offer(nums[i]);
+        }
+        // k+1 番目の要素から、ヒープの長さを k に保つ
+        for (int i = k; i < nums.length; i++) {
+            // 現在の要素がヒープの先頭要素より大きい場合、ヒープの先頭要素を削除し、現在の要素をヒープに入力
+            if (nums[i] > heap.peek()) {
+                heap.poll();
+                heap.offer(nums[i]);
+            }
+        }
+        return heap;
+    }
+
+    public static void main(String[] args) {
+        int[] nums = { 1, 7, 6, 3, 2 };
+        int k = 3;
+
+        Queue<Integer> res = topKHeap(nums, k);
+        System.out.println("最大 " + k + " 個の要素は");
+        PrintUtil.printHeap(res);
+    }
+}