Re-translate the Japanese version (#1871)

* Retranslate Japanese docs with GPT-5.4

* Retranslate Japanese code with GPT-5.4

ja/codes/kotlin/utils/ListNode.kt

@@ -0,0 +1,25 @@
+/**
+ * File: ListNode.kt
+ * Created Time: 2024-01-25
+ * Author: curtishd (1023632660@qq.com)
+ */
+
+package utils
+
+/* 連結リストノード */
+class ListNode(var _val: Int) {
+    var next: ListNode? = null
+
+    companion object {
+        /* リストを連結リストにデシリアライズする */
+        fun arrToLinkedList(arr: IntArray): ListNode? {
+            val dum = ListNode(0)
+            var head = dum
+            for (_val in arr) {
+                head.next = ListNode(_val)
+                head = head.next!!
+            }
+            return dum.next
+        }
+    }
+}

ja/codes/kotlin/utils/PrintUtil.kt

@@ -0,0 +1,107 @@
+/**
+ * File: PrintUtil.kt
+ * Created Time: 2024-01-25
+ * Author: curtishd (1023632660@qq.com)
+ */
+
+package utils
+
+import java.util.*
+
+class Trunk(var prev: Trunk?, var str: String)
+
+/* 行列を出力する（Array） */
+fun <T> printMatrix(matrix: Array<Array<T>>) {
+    println("[")
+    for (row in matrix) {
+        println("  $row,")
+    }
+    println("]")
+}
+
+/* 行列を出力する（List） */
+fun <T> printMatrix(matrix: MutableList<MutableList<T>>) {
+    println("[")
+    for (row in matrix) {
+        println("  $row,")
+    }
+    println("]")
+}
+
+/* 連結リストを出力 */
+fun printLinkedList(h: ListNode?) {
+    var head = h
+    val list = mutableListOf<String>()
+    while (head != null) {
+        list.add(head._val.toString())
+        head = head.next
+    }
+    println(list.joinToString(separator = " -> "))
+}
+
+/* 二分木を出力 */
+fun printTree(root: TreeNode?) {
+    printTree(root, null, false)
+}
+
+/**
+ * 二分木を出力
+ * This tree printer is borrowed from TECHIE DELIGHT
+ * https://www.techiedelight.com/c-program-print-binary-tree/
+ */
+fun printTree(root: TreeNode?, prev: Trunk?, isRight: Boolean) {
+    if (root == null) {
+        return
+    }
+
+    var prevStr = "    "
+    val trunk = Trunk(prev, prevStr)
+
+    printTree(root.right, trunk, true)
+
+    if (prev == null) {
+        trunk.str = "———"
+    } else if (isRight) {
+        trunk.str = "/———"
+        prevStr = "   |"
+    } else {
+        trunk.str = "\\———"
+        prev.str = prevStr
+    }
+
+    showTrunks(trunk)
+    println(" ${root._val}")
+
+    if (prev != null) {
+        prev.str = prevStr
+    }
+    trunk.str = "   |"
+
+    printTree(root.left, trunk, false)
+}
+
+fun showTrunks(p: Trunk?) {
+    if (p == null) {
+        return
+    }
+    showTrunks(p.prev)
+    print(p.str)
+}
+
+/* ハッシュテーブルを出力 */
+fun <K, V> printHashMap(map: Map<K, V>) {
+    for ((key, value) in map) {
+        println("${key.toString()} -> $value")
+    }
+}
+
+/* ヒープを出力 */
+fun printHeap(queue: Queue<Int>?) {
+    val list = mutableListOf<Int?>()
+    queue?.let { list.addAll(it) }
+    print("ヒープの配列表現：")
+    println(list)
+    println("ヒープの木構造表現：")
+    val root = TreeNode.listToTree(list)
+    printTree(root)
+}

ja/codes/kotlin/utils/TreeNode.kt

@@ -0,0 +1,69 @@
+/**
+ * File: TreeNode.kt
+ * Created Time: 2024-01-25
+ * Author: curtishd (1023632660@qq.com)
+ */
+
+package utils
+
+/* 二分木ノードクラス */
+/* コンストラクタ */
+class TreeNode(
+    var _val: Int // ノード値
+) {
+    var height: Int = 0 // ノードの高さ
+    var left: TreeNode? = null // 左子ノードへの参照
+    var right: TreeNode? = null // 右子ノードへの参照
+
+    // シリアライズの符号化規則は以下を参照:
+    // https://www.hello-algo.com/chapter_tree/array_representation_of_tree/
+    // 二分木の配列表現:
+    // [1, 2, 3, 4, None, 6, 7, 8, 9, None, None, 12, None, None, 15]
+    // 二分木の連結リスト表現:
+    // /——— 15
+    // /——— 7
+    // /——— 3
+    // |    \——— 6
+    // |        \——— 12
+    // ——— 1
+    // \——— 2
+    // |    /——— 9
+    // \——— 4
+    // \——— 8
+
+    /* リストを二分木にデシリアライズする: 再帰 */
+    companion object {
+        private fun listToTreeDFS(arr: MutableList<Int?>, i: Int): TreeNode? {
+            if (i < 0 || i >= arr.size || arr[i] == null) {
+                return null
+            }
+            val root = TreeNode(arr[i]!!)
+            root.left = listToTreeDFS(arr, 2 * i + 1)
+            root.right = listToTreeDFS(arr, 2 * i + 2)
+            return root
+        }
+
+        /* リストを二分木にデシリアライズする */
+        fun listToTree(arr: MutableList<Int?>): TreeNode? {
+            return listToTreeDFS(arr, 0)
+        }
+
+        /* 二分木をリストにシリアライズする: 再帰 */
+        private fun treeToListDFS(root: TreeNode?, i: Int, res: MutableList<Int?>) {
+            if (root == null) return
+            while (i >= res.size) {
+                res.add(null)
+            }
+            res[i] = root._val
+            treeToListDFS(root.left, 2 * i + 1, res)
+            treeToListDFS(root.right, 2 * i + 2, res)
+        }
+
+        /* 二分木をリストにシリアライズする */
+        fun treeToList(root: TreeNode?): MutableList<Int?> {
+            val res = mutableListOf<Int?>()
+            treeToListDFS(root, 0, res)
+            return res
+        }
+    }
+}

ja/codes/kotlin/utils/Vertex.kt

@@ -0,0 +1,30 @@
+/**
+ * File: Vertex.kt
+ * Created Time: 2024-01-25
+ * Author: curtishd (1023632660@qq.com)
+ */
+
+package utils
+
+/* 頂点クラス */
+class Vertex(val _val: Int) {
+    companion object {
+        /* 値リスト vals を入力し、頂点リスト vets を返す */
+        fun valsToVets(vals: IntArray): Array<Vertex?> {
+            val vets = arrayOfNulls<Vertex>(vals.size)
+            for (i in vals.indices) {
+                vets[i] = Vertex(vals[i])
+            }
+            return vets
+        }
+
+        /* 頂点リスト vets を入力し、値リスト vals を返す */
+        fun vetsToVals(vets: MutableList<Vertex?>): MutableList<Int> {
+            val vals = mutableListOf<Int>()
+            for (vet in vets) {
+                vals.add(vet!!._val)
+            }
+            return vals
+        }
+    }
+}