Re-translate the Japanese version (#1871)

* Retranslate Japanese docs with GPT-5.4

* Retranslate Japanese code with GPT-5.4

ja/codes/kotlin/chapter_array_and_linkedlist/array.kt

@@ -0,0 +1,102 @@
+/**
+ * File: array.kt
+ * Created Time: 2024-01-25
+ * Author: curtishd (1023632660@qq.com)
+ */
+
+package chapter_array_and_linkedlist
+
+import java.util.concurrent.ThreadLocalRandom
+
+/* 要素へランダムアクセス */
+fun randomAccess(nums: IntArray): Int {
+    // 区間 [0, nums.size) からランダムに数字を 1 つ選ぶ
+    val randomIndex = ThreadLocalRandom.current().nextInt(0, nums.size)
+    // ランダムな要素を取得して返す
+    val randomNum = nums[randomIndex]
+    return randomNum
+}
+
+/* 配列長を拡張する */
+fun extend(nums: IntArray, enlarge: Int): IntArray {
+    // 拡張後の長さを持つ配列を初期化する
+    val res = IntArray(nums.size + enlarge)
+    // 元の配列の全要素を新しい配列にコピー
+    for (i in nums.indices) {
+        res[i] = nums[i]
+    }
+    // 拡張後の新しい配列を返す
+    return res
+}
+
+/* 配列の index 番目に要素 num を挿入 */
+fun insert(nums: IntArray, num: Int, index: Int) {
+    // インデックス index 以降の全要素を 1 つ後ろへ移動する
+    for (i in nums.size - 1 downTo index + 1) {
+        nums[i] = nums[i - 1]
+    }
+    // index の要素に num を代入する
+    nums[index] = num
+}
+
+/* index の要素を削除する */
+fun remove(nums: IntArray, index: Int) {
+    // インデックス index より後ろの全要素を 1 つ前へ移動する
+    for (i in index..<nums.size - 1) {
+        nums[i] = nums[i + 1]
+    }
+}
+
+/* 配列を走査 */
+fun traverse(nums: IntArray) {
+    var count = 0
+    // インデックスで配列を走査
+    for (i in nums.indices) {
+        count += nums[i]
+    }
+    // 配列要素を直接走査
+    for (j in nums) {
+        count += j
+    }
+}
+
+/* 配列内で指定要素を探す */
+fun find(nums: IntArray, target: Int): Int {
+    for (i in nums.indices) {
+        if (nums[i] == target)
+            return i
+    }
+    return -1
+}
+
+/* Driver Code */
+fun main() {
+    /* 配列を初期化 */
+    val arr = IntArray(5)
+    println("配列 arr = ${arr.contentToString()}")
+    var nums = intArrayOf(1, 3, 2, 5, 4)
+    println("配列 nums = ${nums.contentToString()}")
+
+    /* ランダムアクセス */
+    val randomNum: Int = randomAccess(nums)
+    println("nums からランダムな要素 $randomNum を取得")
+
+    /* 長さを拡張 */
+    nums = extend(nums, 3)
+    println("配列の長さを 8 まで拡張し，nums = ${nums.contentToString()}")
+
+    /* 要素を挿入する */
+    insert(nums, 6, 3)
+    println("インデックス 3 に数値 6 を挿入し，nums = ${nums.contentToString()}")
+
+    /* 要素を削除 */
+    remove(nums, 2)
+    println("インデックス 2 の要素を削除し，nums = ${nums.contentToString()}")
+
+    /* 配列を走査 */
+    traverse(nums)
+
+    /* 要素を探索する */
+    val index: Int = find(nums, 3)
+    println("nums 内で要素 3 を検索し，インデックス = $index")
+}

ja/codes/kotlin/chapter_array_and_linkedlist/linked_list.kt

@@ -0,0 +1,88 @@
+/**
+ * File: linked_list.kt
+ * Created Time: 2024-01-25
+ * Author: curtishd (1023632660@qq.com)
+ */
+
+package chapter_array_and_linkedlist
+
+import utils.ListNode
+import utils.printLinkedList
+
+/* 連結リストでノード n0 の後ろにノード P を挿入する */
+fun insert(n0: ListNode?, p: ListNode?) {
+    val n1 = n0?.next
+    p?.next = n1
+    n0?.next = p
+}
+
+/* 連結リストでノード n0 の直後のノードを削除する */
+fun remove(n0: ListNode?) {
+    if (n0?.next == null)
+        return
+    // n0 -> P -> n1
+    val p = n0.next
+    val n1 = p?.next
+    n0.next = n1
+}
+
+/* 連結リスト内で index 番目のノードにアクセス */
+fun access(head: ListNode?, index: Int): ListNode? {
+    var h = head
+    for (i in 0..<index) {
+        if (h == null)
+            return null
+        h = h.next
+    }
+    return h
+}
+
+/* 連結リストで値が target の最初のノードを探す */
+fun find(head: ListNode?, target: Int): Int {
+    var index = 0
+    var h = head
+    while (h != null) {
+        if (h._val == target)
+            return index
+        h = h.next
+        index++
+    }
+    return -1
+}
+
+/* Driver Code */
+fun main() {
+    /* 連結リストを初期化 */
+    // 各ノードを初期化
+    val n0 = ListNode(1)
+    val n1 = ListNode(3)
+    val n2 = ListNode(2)
+    val n3 = ListNode(5)
+    val n4 = ListNode(4)
+
+    // ノード間の参照を構築する
+    n0.next = n1
+    n1.next = n2
+    n2.next = n3
+    n3.next = n4
+    println("初期化した連結リストは")
+    printLinkedList(n0)
+
+    /* ノードを挿入 */
+    insert(n0, ListNode(0))
+    println("ノード挿入後の連結リストは")
+    printLinkedList(n0)
+
+    /* ノードを削除 */
+    remove(n0)
+    println("ノード削除後の連結リストは")
+    printLinkedList(n0)
+
+    /* ノードにアクセス */
+    val node = access(n0, 3)!!
+    println("連結リストのインデックス 3 にあるノードの値 = ${node._val}")
+
+    /* ノードを探索 */
+    val index = find(n0, 2)
+    println("連結リスト内で値が 2 のノードのインデックス = $index")
+}

ja/codes/kotlin/chapter_array_and_linkedlist/list.kt

@@ -0,0 +1,63 @@
+/**
+ * File: list.kt
+ * Created Time: 2024-01-25
+ * Author: curtishd (1023632660@qq.com)
+ */
+
+package chapter_array_and_linkedlist
+
+/* Driver Code */
+fun main() {
+    /* リストを初期化 */
+    // 可変集合
+    val nums = mutableListOf(1, 3, 2, 5, 4)
+    println("リスト nums = $nums")
+
+    /* 要素にアクセス */
+    val num = nums[1]
+    println("インデックス 1 の要素にアクセスし，num = $num")
+
+    /* 要素を更新 */
+    nums[1] = 0
+    println("インデックス 1 の要素を 0 に更新し，nums = $nums")
+
+    /* リストを空にする */
+    nums.clear()
+    println("リストを空にした後の nums = $nums")
+
+    /* 末尾に要素を追加 */
+    nums.add(1)
+    nums.add(3)
+    nums.add(2)
+    nums.add(5)
+    nums.add(4)
+    println("要素追加後の nums = $nums")
+
+    /* 中間に要素を挿入 */
+    nums.add(3, 6)
+    println("インデックス 3 に数値 6 を挿入し，nums = $nums")
+
+    /* 要素を削除 */
+    nums.removeAt(3)
+    println("インデックス 3 の要素を削除し，nums = $nums")
+
+    /* インデックスでリストを走査 */
+    var count = 0
+    for (i in nums.indices) {
+        count += nums[i]
+    }
+
+    /* リスト要素を直接走査 */
+    for (j in nums) {
+        count += j
+    }
+
+    /* 2 つのリストを連結する */
+    val nums1 = mutableListOf(6, 8, 7, 10, 9)
+    nums.addAll(nums1)
+    println("リスト nums1 を nums の後ろに連結し，nums = $nums")
+
+    /* リストをソート */
+    nums.sort()
+    println("リストをソートした後の nums = $nums")
+}

ja/codes/kotlin/chapter_array_and_linkedlist/my_list.kt

@@ -0,0 +1,139 @@
+/**
+ * File: my_list.kt
+ * Created Time: 2024-01-25
+ * Author: curtishd (1023632660@qq.com)
+ */
+
+package chapter_array_and_linkedlist
+
+/* リストクラス */
+class MyList {
+    private var arr: IntArray = intArrayOf() // 配列（リスト要素を格納）
+    private var capacity: Int = 10 // リスト容量
+    private var size: Int = 0 // リストの長さ（現在の要素数）
+    private var extendRatio: Int = 2 // リスト拡張時の増加倍率
+
+    /* コンストラクタ */
+    init {
+        arr = IntArray(capacity)
+    }
+
+    /* リストの長さを取得（現在の要素数） */
+    fun size(): Int {
+        return size
+    }
+
+    /* リスト容量を取得する */
+    fun capacity(): Int {
+        return capacity
+    }
+
+    /* 要素にアクセス */
+    fun get(index: Int): Int {
+        // インデックスが範囲外なら例外を送出する。以下同様
+        if (index < 0 || index >= size)
+            throw IndexOutOfBoundsException("インデックスが範囲外")
+        return arr[index]
+    }
+
+    /* 要素を更新 */
+    fun set(index: Int, num: Int) {
+        if (index < 0 || index >= size)
+            throw IndexOutOfBoundsException("インデックスが範囲外")
+        arr[index] = num
+    }
+
+    /* 末尾に要素を追加 */
+    fun add(num: Int) {
+        // 要素数が容量を超えると、拡張機構が発動する
+        if (size == capacity())
+            extendCapacity()
+        arr[size] = num
+        // 要素数を更新
+        size++
+    }
+
+    /* 中間に要素を挿入 */
+    fun insert(index: Int, num: Int) {
+        if (index < 0 || index >= size)
+            throw IndexOutOfBoundsException("インデックスが範囲外")
+        // 要素数が容量を超えると、拡張機構が発動する
+        if (size == capacity())
+            extendCapacity()
+        // index 以降の要素をすべて 1 つ後ろへずらす
+        for (j in size - 1 downTo index)
+            arr[j + 1] = arr[j]
+        arr[index] = num
+        // 要素数を更新
+        size++
+    }
+
+    /* 要素を削除 */
+    fun remove(index: Int): Int {
+        if (index < 0 || index >= size)
+            throw IndexOutOfBoundsException("インデックスが範囲外")
+        val num = arr[index]
+        // インデックス index より後の要素をすべて 1 つ前に移動する
+        for (j in index..<size - 1)
+            arr[j] = arr[j + 1]
+        // 要素数を更新
+        size--
+        // 削除された要素を返す
+        return num
+    }
+
+    /* リストの拡張 */
+    fun extendCapacity() {
+        // 元の配列の extendRatio 倍の長さを持つ新しい配列を作成し、元の配列をコピーする
+        arr = arr.copyOf(capacity() * extendRatio)
+        // リストの容量を更新
+        capacity = arr.size
+    }
+
+    /* リストを配列に変換する */
+    fun toArray(): IntArray {
+        val size = size()
+        // 有効長の範囲内のリスト要素のみを変換
+        val arr = IntArray(size)
+        for (i in 0..<size) {
+            arr[i] = get(i)
+        }
+        return arr
+    }
+}
+
+/* Driver Code */
+fun main() {
+    /* リストを初期化 */
+    val nums = MyList()
+    /* 末尾に要素を追加 */
+    nums.add(1)
+    nums.add(3)
+    nums.add(2)
+    nums.add(5)
+    nums.add(4)
+    println("リスト nums = ${nums.toArray().contentToString()}，容量 = ${nums.capacity()}，長さ = ${nums.size()}")
+
+    /* 中間に要素を挿入 */
+    nums.insert(3, 6)
+    println("インデックス 3 に数値 6 を挿入し，nums = ${nums.toArray().contentToString()}")
+
+    /* 要素を削除 */
+    nums.remove(3)
+    println("インデックス 3 の要素を削除し，nums = ${nums.toArray().contentToString()}")
+
+    /* 要素にアクセス */
+    val num = nums.get(1)
+    println("インデックス 1 の要素にアクセスし，num = $num")
+
+    /* 要素を更新 */
+    nums.set(1, 0)
+    println("インデックス 1 の要素を 0 に更新し，nums = ${nums.toArray().contentToString()}")
+
+    /* 拡張機構をテストする */
+    for (i in 0..9) {
+        // i = 5 のとき、リスト長が容量を超えるため、この時点で拡張機構が発動する
+        nums.add(i)
+    }
+    println("拡張後のリスト nums = ${nums.toArray().contentToString()}，容量 = ${nums.capacity()}，長さ =  ${nums.size()}")
+}