Re-translate the Japanese version (#1871)

* Retranslate Japanese docs with GPT-5.4

* Retranslate Japanese code with GPT-5.4

ja/codes/ruby/chapter_array_and_linkedlist/array.rb

@@ -0,0 +1,108 @@
+=begin
+File: array.rb
+Created Time: 2024-03-18
+Author: Xuan Khoa Tu Nguyen (ngxktuzkai2000@gmail.com)
+=end
+
+### 要素にランダムアクセス ###
+def random_access(nums)
+  # 区間 [0, nums.length) からランダムに 1 つの数を選ぶ
+  random_index = Random.rand(0...nums.length)
+
+  # ランダムな要素を取得して返す
+  nums[random_index]
+end
+
+
+### 配列長を拡張 ###
+# Ruby の Array は動的配列であり、直接拡張できます
+# 学習しやすいよう、本関数では Array を長さ不変の配列として扱います
+def extend(nums, enlarge)
+  # 拡張後の長さを持つ配列を初期化する
+  res = Array.new(nums.length + enlarge, 0)
+
+  # 元の配列の全要素を新しい配列にコピー
+  for i in 0...nums.length
+    res[i] = nums[i]
+  end
+
+  # 拡張後の新しい配列を返す
+  res
+end
+
+### 配列のインデックス index に要素 num を挿入 ###
+def insert(nums, num, index)
+  # インデックス index 以降の全要素を 1 つ後ろへ移動する
+  for i in (nums.length - 1).downto(index + 1)
+    nums[i] = nums[i - 1]
+  end
+
+  # index の要素に num を代入する
+  nums[index] = num
+end
+
+
+### インデックス index の要素を削除 ###
+def remove(nums, index)
+  # インデックス index より後ろの全要素を 1 つ前へ移動する
+  for i in index...(nums.length - 1)
+    nums[i] = nums[i + 1]
+  end
+end
+
+### 配列を走査 ###
+def traverse(nums)
+  count = 0
+
+  # インデックスで配列を走査
+  for i in 0...nums.length
+    count += nums[i]
+  end
+
+  # 配列要素を直接走査
+  for num in nums
+    count += num
+  end
+end
+
+### 配列内の指定要素を検索 ###
+def find(nums, target)
+  for i in 0...nums.length
+    return i if nums[i] == target
+  end
+
+  -1
+end
+
+
+### Driver Code ###
+if __FILE__ == $0
+  # 配列を初期化
+  arr = Array.new(5, 0)
+  puts "配列 arr = #{arr}"
+  nums = [1, 3, 2, 5, 4]
+  puts "配列 nums = #{nums}"
+
+  # ランダムアクセス
+  random_num = random_access(nums)
+  puts "nums からランダムな要素 #{random_num} を取得"
+
+  # 長さを拡張
+  nums = extend(nums, 3)
+  puts "配列の長さを 8 に拡張し、nums = #{nums}"
+
+  # 要素を挿入する
+  insert(nums, 6, 3)
+  puts "インデックス 3 に数値 6 を挿入し、nums = #{nums}"
+
+  # 要素を削除
+  remove(nums, 2)
+  puts "インデックス 2 の要素を削除し、nums = #{nums}"
+
+  # 配列を走査
+  traverse(nums)
+
+  # 要素を探索する
+  index = find(nums, 3)
+  puts "nums 内で要素 3 を検索し、インデックス = #{index}"
+end

ja/codes/ruby/chapter_array_and_linkedlist/linked_list.rb

@@ -0,0 +1,83 @@
+=begin
+File: linked_list.rb
+Created Time: 2024-03-18
+Author: Xuan Khoa Tu Nguyen (ngxktuzkai2000@gmail.com)
+=end
+
+require_relative '../utils/list_node'
+require_relative '../utils/print_util'
+
+### 連結リストのノード n0 の後にノード _p を挿入 ###
+# Ruby の `p` は組み込み関数で、`P` は定数なので、代わりに `_p` を使える
+def insert(n0, _p)
+  n1 = n0.next
+  _p.next = n1
+  n0.next = _p
+end
+
+### 連結リストのノード n0 の直後のノードを削除 ###
+def remove(n0)
+  return if n0.next.nil?
+
+  # n0 -> remove_node -> n1
+  remove_node = n0.next
+  n1 = remove_node.next
+  n0.next = n1
+end
+
+### 連結リスト内の index 番目のノードにアクセス ###
+def access(head, index)
+  for i in 0...index
+    return nil if head.nil?
+    head = head.next
+  end
+
+  head
+end
+
+### 連結リストで値が target の最初のノードを探す ###
+def find(head, target)
+  index = 0
+  while head
+    return index if head.val == target
+    head = head.next
+    index += 1
+  end
+
+  -1
+end
+
+### Driver Code ###
+if __FILE__ == $0
+  # 連結リストを初期化する
+  # 各ノードを初期化する
+  n0 = ListNode.new(1)
+  n1 = ListNode.new(3)
+  n2 = ListNode.new(2)
+  n3 = ListNode.new(5)
+  n4 = ListNode.new(4)
+  # ノード間の参照を構築する
+  n0.next = n1
+  n1.next = n2
+  n2.next = n3
+  n3.next = n4
+  puts "初期化した連結リストは"
+  print_linked_list(n0)
+
+  # ノードを挿入
+  insert(n0, ListNode.new(0))
+  print_linked_list n0
+
+  # ノードを削除
+  remove(n0)
+  puts "ノード削除後の連結リストは"
+  print_linked_list(n0)
+
+  # ノードにアクセス
+  node = access(n0, 3)
+  puts "連結リストのインデックス 3 にあるノードの値 = #{node.val}"
+
+  # ノードを探索
+  index = find(n0, 2)
+  puts "連結リスト内で値が 2 のノードのインデックス = #{index}"
+end

ja/codes/ruby/chapter_array_and_linkedlist/list.rb

@@ -0,0 +1,60 @@
+=begin
+File: list.rb
+Created Time: 2024-03-18
+Author: Xuan Khoa Tu Nguyen (ngxktuzkai2000@gmail.com)
+=end
+
+### Driver Code ###
+if __FILE__ == $0
+  # リストを初期化
+  nums = [1, 3, 2, 5, 4]
+  puts "リスト nums = #{nums}"
+
+  # 要素にアクセス
+  num = nums[1]
+  puts "インデックス 1 の要素にアクセスし、num = #{num}"
+
+  # 要素を更新
+  nums[1] = 0
+  puts "インデックス 1 の要素を 0 に更新し、nums = #{nums}"
+
+  # リストを空にする
+  nums.clear
+  puts "リストを空にした後 nums = #{nums}"
+
+  # 末尾に要素を追加
+  nums << 1
+  nums << 3
+  nums << 2
+  nums << 5
+  nums << 4
+  puts "要素追加後 nums = #{nums}"
+
+  # 中間に要素を挿入
+  nums.insert(3, 6)
+  puts "インデックス 3 に要素 6 を挿入し、nums = #{nums}"
+
+  # 要素を削除
+  nums.delete_at(3)
+  puts "インデックス 3 の要素を削除し、nums = #{nums}"
+
+  # インデックスでリストを走査
+  count = 0
+  for i in 0...nums.length
+    count += nums[i]
+  end
+
+  # リスト要素を直接走査
+  count = 0
+  nums.each do |x|
+    count += x
+  end
+
+  # 2 つのリストを連結する
+  nums1 = [6, 8, 7, 10, 9]
+  nums += nums1
+  puts "リスト nums1 を nums の後ろに連結し、nums = #{nums}"
+
+  nums = nums.sort { |a, b| a <=> b }
+  puts "リストをソートした後 nums = #{nums}"
+end

ja/codes/ruby/chapter_array_and_linkedlist/my_list.rb

@@ -0,0 +1,132 @@
+=begin
+File: my_list.rb
+Created Time: 2024-03-18
+Author: Xuan Khoa Tu Nguyen (ngxktuzkai2000@gmail.com)
+=end
+
+### リストクラス ###
+class MyList
+  attr_reader :size       # リストの長さを取得（現在の要素数）
+  attr_reader :capacity   # リスト容量を取得する
+
+  ### コンストラクタ ###
+  def initialize
+    @capacity = 10
+    @size = 0
+    @extend_ratio = 2
+    @arr = Array.new(capacity)
+  end
+
+  ### 要素にアクセス ###
+  def get(index)
+    # インデックスが範囲外なら例外を送出する。以下同様
+    raise IndexError, "インデックスが範囲外です" if index < 0 || index >= size
+    @arr[index]
+  end
+
+  ### 要素にアクセス ###
+  def set(index, num)
+    raise IndexError, "インデックスが範囲外です" if index < 0 || index >= size
+    @arr[index] = num
+  end
+
+  ### 末尾に要素を追加 ###
+  def add(num)
+    # 要素数が容量を超えると、拡張機構が発動する
+    extend_capacity if size == capacity
+    @arr[size] = num
+
+    # 要素数を更新
+    @size += 1
+  end
+
+  ### 途中に要素を挿入 ###
+  def insert(index, num)
+    raise IndexError, "インデックスが範囲外です" if index < 0 || index >= size
+
+    # 要素数が容量を超えると、拡張機構が発動する
+    extend_capacity if size == capacity
+
+    # index 以降の要素をすべて 1 つ後ろへずらす
+    for j in (size - 1).downto(index)
+      @arr[j + 1] = @arr[j]
+    end
+    @arr[index] = num
+
+    # 要素数を更新
+    @size += 1
+  end
+
+  ### 要素の削除 ###
+  def remove(index)
+    raise IndexError, "インデックスが範囲外です" if index < 0 || index >= size
+    num = @arr[index]
+
+    # インデックス index より後の要素をすべて 1 つ前に移動する
+    for j in index...size
+      @arr[j] = @arr[j + 1]
+    end
+
+    # 要素数を更新
+    @size -= 1
+
+    # 削除された要素を返す
+    num
+  end
+
+  ### リストの容量拡張 ###
+  def extend_capacity
+    # 元の配列の extend_ratio 倍の長さを持つ新しい配列を作成し、元の配列をコピーする
+    arr = @arr.dup + Array.new(capacity * (@extend_ratio - 1))
+    # リストの容量を更新
+    @capacity = arr.length
+  end
+
+  ### リストを配列に変換 ###
+  def to_array
+    sz = size
+    # 有効長の範囲内のリスト要素のみを変換
+    arr = Array.new(sz)
+    for i in 0...sz
+      arr[i] = get(i)
+    end
+    arr
+  end
+end
+
+### Driver Code ###
+if __FILE__ == $0
+  # リストを初期化
+  nums = MyList.new
+
+  # 末尾に要素を追加
+  nums.add(1)
+  nums.add(3)
+  nums.add(2)
+  nums.add(5)
+  nums.add(4)
+  puts "リスト nums = #{nums.to_array}、容量 = #{nums.capacity}、長さ = #{nums.size}"
+
+  # 中間に要素を挿入
+  nums.insert(3, 6)
+  puts "インデックス 3 に数値 6 を挿入し、nums = #{nums.to_array}"
+
+  # 要素を削除
+  nums.remove(3)
+  puts "インデックス 3 の要素を削除し、nums = #{nums.to_array}"
+
+  # 要素にアクセス
+  num = nums.get(1)
+  puts "インデックス 1 の要素にアクセスし、num = #{num}"
+
+  # 要素を更新
+  nums.set(1, 0)
+  puts "インデックス 1 の要素を 0 に更新し、nums = #{nums.to_array}"
+
+  # 拡張機構をテストする
+  for i in 0...10
+    # i = 5 のとき、リスト長が容量を超えるため、この時点で拡張機構が発動する
+    nums.add(i)
+  end
+  puts "拡張後のリスト nums = #{nums.to_array}、容量 = #{nums.capacity}、長さ = #{nums.size}"
+end