Re-translate the Japanese version (#1871)

* Retranslate Japanese docs with GPT-5.4

* Retranslate Japanese code with GPT-5.4

ja/codes/ruby/chapter_stack_and_queue/array_deque.rb

@@ -0,0 +1,145 @@
+=begin
+File: array_deque.rb
+Created Time: 2024-04-05
+Author: Xuan Khoa Tu Nguyen (ngxktuzkai2000@gmail.com)
+=end
+
+### 循環配列で実装した両端キュー ###
+class ArrayDeque
+  ### 両端キューの長さを取得 ###
+  attr_reader :size
+
+  ### コンストラクタ ###
+  def initialize(capacity)
+    @nums = Array.new(capacity, 0)
+    @front = 0
+    @size = 0
+  end
+
+  ### 両端キューの容量を取得 ###
+  def capacity
+    @nums.length
+  end
+
+  ### 両端キューが空か判定 ###
+  def is_empty?
+    size.zero?
+  end
+
+  ### キュー先頭に追加 ###
+  def push_first(num)
+    if size == capacity
+      puts '両端キューがいっぱいです'
+      return
+    end
+
+    # 先頭ポインタを左に 1 つ移動する
+    # 剰余演算により、front が配列先頭を越えた後に末尾へ戻るようにする
+    @front = index(@front - 1)
+    # num をキュー先頭に追加
+    @nums[@front] = num
+    @size += 1
+  end
+
+  ### キュー末尾に追加 ###
+  def push_last(num)
+    if size == capacity
+      puts '両端キューがいっぱいです'
+      return
+    end
+
+    # キュー末尾ポインタを計算し、末尾インデックス + 1 を指す
+    rear = index(@front + size)
+    # num をキュー末尾に追加
+    @nums[rear] = num
+    @size += 1
+  end
+
+  ### キュー先頭から取り出す ###
+  def pop_first
+    num = peek_first
+    # 先頭ポインタを 1 つ後ろへ進める
+    @front = index(@front + 1)
+    @size -= 1
+    num
+  end
+
+  ### キューの末尾から取り出す ###
+  def pop_last
+    num = peek_last
+    @size -= 1
+    num
+  end
+
+  ### 先頭要素にアクセス ###
+  def peek_first
+    raise IndexError, '両端キューは空です' if is_empty?
+
+    @nums[@front]
+  end
+
+  ### キュー末尾要素を参照 ###
+  def peek_last
+    raise IndexError, '両端キューは空です' if is_empty?
+
+    # 末尾要素のインデックスを計算
+    last = index(@front + size - 1)
+    @nums[last]
+  end
+
+  ### 表示用の配列を返す ###
+  def to_array
+    # 有効長の範囲内のリスト要素のみを変換
+    res = []
+    for i in 0...size
+      res << @nums[index(@front + i)]
+    end
+    res
+  end
+
+  private
+
+  ### 循環配列のインデックスを計算 ###
+  def index(i)
+    # 剰余演算により配列の先頭と末尾をつなげる
+    # i が配列の末尾を越えたら先頭に戻る
+    # i が配列の先頭を越えて前に出たら末尾に戻る
+    (i + capacity) % capacity
+  end
+end
+
+### Driver Code ###
+if __FILE__ == $0
+  # 両端キューを初期化
+  deque = ArrayDeque.new(10)
+  deque.push_last(3)
+  deque.push_last(2)
+  deque.push_last(5)
+  puts "両端キュー deque = #{deque.to_array}"
+
+  # 要素にアクセス
+  peek_first = deque.peek_first
+  puts "先頭要素 peek_first = #{peek_first}"
+  peek_last = deque.peek_last
+  puts "末尾要素 peek_last = #{peek_last}"
+
+  # 要素をエンキュー
+  deque.push_last(4)
+  puts "要素 4 を末尾に追加後 deque = #{deque.to_array}"
+  deque.push_first(1)
+  puts "要素 1 を末尾に追加後 deque = #{deque.to_array}"
+
+  # 要素をデキュー
+  pop_last = deque.pop_last
+  puts "末尾から取り出した要素 = #{pop_last}，末尾から取り出した後 deque = #{deque.to_array}"
+  pop_first = deque.pop_first
+  puts "末尾から取り出した要素 = #{pop_first}，末尾から取り出した後 deque = #{deque.to_array}"
+
+  # 両端キューの長さを取得
+  size = deque.size
+  puts "両端キューの長さ size = #{size}"
+
+  # 両端キューが空かどうかを判定
+  is_empty = deque.is_empty?
+  puts "両端キューが空かどうか = #{is_empty}"
+end

ja/codes/ruby/chapter_stack_and_queue/array_queue.rb

@@ -0,0 +1,107 @@
+=begin
+File: array_queue.rb
+Created Time: 2024-04-05
+Author: Xuan Khoa Tu Nguyen (ngxktuzkai2000@gmail.com)
+=end
+
+### 循環配列で実装したキュー ###
+class ArrayQueue
+  ### キューの長さを取得 ###
+  attr_reader :size
+
+  ### コンストラクタ ###
+  def initialize(size)
+    @nums = Array.new(size, 0) # キュー要素を格納する配列
+    @front = 0 # 先頭ポインタ。先頭要素を指す
+    @size = 0 # キューの長さ
+  end
+
+  ### キューの容量を取得 ###
+  def capacity
+    @nums.length
+  end
+
+  ### キューが空か判定 ###
+  def is_empty?
+    size.zero?
+  end
+
+  ### エンキュー ###
+  def push(num)
+    raise IndexError, 'キューがいっぱいです' if size == capacity
+
+    # 末尾ポインタを計算し、末尾インデックス + 1 を指す
+    # 剰余演算により、rear が配列末尾を越えた後に先頭へ戻るようにする
+    rear = (@front + size) % capacity
+    # num をキュー末尾に追加
+    @nums[rear] = num
+    @size += 1
+  end
+
+  ### デキュー ###
+  def pop
+    num = peek
+    # 先頭ポインタを1つ後ろへ進め、末尾を越えたら配列先頭に戻す
+    @front = (@front + 1) % capacity
+    @size -= 1
+    num
+  end
+
+  ### 先頭要素にアクセス ###
+  def peek
+    raise IndexError, 'キューは空です' if is_empty?
+
+    @nums[@front]
+  end
+
+  ### 表示用のリストを返す ###
+  def to_array
+    res = Array.new(size, 0)
+    j = @front
+
+    for i in 0...size
+      res[i] = @nums[j % capacity]
+      j += 1
+    end
+
+    res
+  end
+end
+
+### Driver Code ###
+if __FILE__ == $0
+  # キューを初期化
+  queue = ArrayQueue.new(10)
+
+  # 要素をエンキュー
+  queue.push(1)
+  queue.push(3)
+  queue.push(2)
+  queue.push(5)
+  queue.push(4)
+  puts "キュー queue = #{queue.to_array}"
+
+  # キュー先頭の要素にアクセス
+  peek = queue.peek
+  puts "先頭要素 peek = #{peek}"
+
+  # 要素をデキュー
+  pop = queue.pop
+  puts "取り出した要素 pop = #{pop}"
+  puts "取り出し後 queue = #{queue.to_array}"
+
+  # キューの長さを取得
+  size = queue.size
+  puts "キューの長さ size = #{size}"
+
+  # キューが空かどうかを判定
+  is_empty = queue.is_empty?
+  puts "キューが空かどうか = #{is_empty}"
+
+  # 循環配列をテストする
+  for i in 0...10
+    queue.push(i)
+    queue.pop
+    puts "第 #{i} 回の追加 + 取り出し後 queue = #{queue.to_array}"
+  end
+end

ja/codes/ruby/chapter_stack_and_queue/array_stack.rb

@@ -0,0 +1,78 @@
+=begin
+File: array_stack.rb
+Created Time: 2024-04-06
+Author: Xuan Khoa Tu Nguyen (ngxktuzkai2000@gmail.com)
+=end
+
+### 配列で実装したスタック ###
+class ArrayStack
+  ### コンストラクタ ###
+  def initialize
+    @stack = []
+  end
+
+  ### スタックの長さを取得 ###
+  def size
+    @stack.length
+  end
+
+  ### スタックが空か判定 ###
+  def is_empty?
+    @stack.empty?
+  end
+
+  ### プッシュ ###
+  def push(item)
+    @stack << item
+  end
+
+  ### ポップ ###
+  def pop
+    raise IndexError, 'スタックは空です' if is_empty?
+
+    @stack.pop
+  end
+
+  ### スタックトップ要素を参照 ###
+  def peek
+    raise IndexError, 'スタックは空です' if is_empty?
+
+    @stack.last
+  end
+
+  ### 表示用のリストを返す ###
+  def to_array
+    @stack
+  end
+end
+
+### Driver Code ###
+if __FILE__ == $0
+  # スタックを初期化
+  stack = ArrayStack.new
+
+  # 要素をプッシュ
+  stack.push(1)
+  stack.push(3)
+  stack.push(2)
+  stack.push(5)
+  stack.push(4)
+  puts "スタック stack = #{stack.to_array}"
+
+  # スタックトップの要素にアクセス
+  peek = stack.peek
+  puts "スタックトップ要素 peek = #{peek}"
+
+  # 要素をポップ
+  pop = stack.pop
+  puts "ポップした要素 pop = #{pop}"
+  puts "ポップ後 stack = #{stack.to_array}"
+
+  # スタックの長さを取得
+  size = stack.size
+  puts "スタックの長さ size = #{size}"
+
+  # 空かどうかを判定
+  is_empty = stack.is_empty?
+  puts "スタックが空かどうか = #{is_empty}"
+end

ja/codes/ruby/chapter_stack_and_queue/deque.rb

@@ -0,0 +1,42 @@
+=begin
+File: deque.rb
+Created Time: 2024-04-06
+Author: Xuan Khoa Tu Nguyen (ngxktuzkai2000@gmail.com)
+=end
+
+### Driver Code ###
+if __FILE__ == $0
+  # 両端キューを初期化する
+  # Ruby には組み込みの両端キューがないため、Array を両端キューとして使う
+  deque = []
+
+  # 要素をキューに入れる
+  deque << 2
+  deque << 5
+  deque << 4
+  # 注意：配列であるため、Array#unshift メソッドの時間計算量は O(n) です
+  deque.unshift(3)
+  deque.unshift(1)
+  puts "両端キュー deque = #{deque}"
+
+  # 要素にアクセス
+  peek_first = deque.first
+  puts "先頭要素 peek_first = #{peek_first}"
+  peek_last = deque.last
+  puts "末尾要素 peek_last = #{peek_last}"
+
+  # 要素をキューから取り出す
+  # 配列であるため、Array#shift メソッドの時間計算量は O(n) である
+  pop_front = deque.shift
+  puts "先頭から取り出した要素 pop_front = #{pop_front}，先頭から取り出した後 deque = #{deque}"
+  pop_back = deque.pop
+  puts "末尾から取り出した要素 pop_back = #{pop_back}, 末尾から取り出した後 deque = #{deque}"
+
+  # 両端キューの長さを取得
+  size = deque.length
+  puts "両端キューの長さ size = #{size}"
+
+  # 両端キューが空かどうかを判定
+  is_empty = size.zero?
+  puts "両端キューが空かどうか = #{is_empty}"
+end

ja/codes/ruby/chapter_stack_and_queue/linkedlist_deque.rb

@@ -0,0 +1,168 @@
+=begin
+File: linkedlist_deque.rb
+Created Time: 2024-04-06
+Author: Xuan Khoa Tu Nguyen (ngxktuzkai2000@gmail.com)
+=end
+
+# ## 双方向連結リストノード
+class ListNode
+  attr_accessor :val
+  attr_accessor :next # 後続ノードへの参照
+  attr_accessor :prev # 前ノードへの参照
+
+  ### コンストラクタ ###
+  def initialize(val)
+    @val = val
+  end
+end
+
+### 双方向連結リストで実装した両端キュー ###
+class LinkedListDeque
+  ### 両端キューの長さを取得 ###
+  attr_reader :size
+
+  ### コンストラクタ ###
+  def initialize
+    @front = nil  # 先頭ノード front
+    @rear = nil   # 末尾ノード rear
+    @size = 0     # 両端キューの長さ
+  end
+
+  ### 両端キューが空か判定 ###
+  def is_empty?
+    size.zero?
+  end
+
+  ### エンキュー操作 ###
+  def push(num, is_front)
+    node = ListNode.new(num)
+    # 連結リストが空なら、`front` と `rear` の両方を `node` に向ける
+    if is_empty?
+      @front = @rear = node
+    # 先頭へのエンキュー操作
+    elsif is_front
+      # node を連結リストの先頭に追加
+      @front.prev = node
+      node.next = @front
+      @front = node # 先頭ノードを更新する
+    # 末尾へのエンキュー操作
+    else
+      # node を連結リストの末尾に追加
+      @rear.next = node
+      node.prev = @rear
+      @rear = node # 末尾ノードを更新する
+    end
+    @size += 1 # キューの長さを更新
+  end
+
+  ### キュー先頭に追加 ###
+  def push_first(num)
+    push(num, true)
+  end
+
+  ### キュー末尾に追加 ###
+  def push_last(num)
+    push(num, false)
+  end
+
+  ### デキュー操作 ###
+  def pop(is_front)
+    raise IndexError, '両端キューは空です' if is_empty?
+
+    # キュー先頭からの取り出し
+    if is_front
+      val = @front.val # 先頭ノードの値を一時保存
+      # 先頭ノードを削除
+      fnext = @front.next
+      unless fnext.nil?
+        fnext.prev = nil
+        @front.next = nil
+      end
+      @front = fnext # 先頭ノードを更新する
+    # キュー末尾からの取り出し
+    else
+      val = @rear.val # 末尾ノードの値を一時保存
+      # 末尾ノードを削除
+      rprev = @rear.prev
+      unless rprev.nil?
+        rprev.next = nil
+        @rear.prev = nil
+      end
+      @rear = rprev # 末尾ノードを更新する
+    end
+    @size -= 1 # キューの長さを更新
+
+    val
+  end
+
+  ### キュー先頭から取り出す ###
+  def pop_first
+    pop(true)
+  end
+
+  ### キュー先頭から取り出す ###
+  def pop_last
+    pop(false)
+  end
+
+  ### 先頭要素にアクセス ###
+  def peek_first
+    raise IndexError, '両端キューは空です' if is_empty?
+
+    @front.val
+  end
+
+  ### キュー末尾要素を参照 ###
+  def peek_last
+    raise IndexError, '両端キューは空です' if is_empty?
+
+    @rear.val
+  end
+
+  ### 表示用の配列を返す ###
+  def to_array
+    node = @front
+    res = Array.new(size, 0)
+    for i in 0...size
+      res[i] = node.val
+      node = node.next
+    end
+    res
+  end
+end
+
+### Driver Code ###
+if __FILE__ == $0
+  # 両端キューを初期化
+  deque = LinkedListDeque.new
+  deque.push_last(3)
+  deque.push_last(2)
+  deque.push_last(5)
+  puts "両端キュー deque = #{deque.to_array}"
+
+  # 要素にアクセス
+  peek_first = deque.peek_first
+  puts "先頭要素 peek_first = #{peek_first}"
+  peek_last = deque.peek_last
+  puts "先頭要素 peek_last = #{peek_last}"
+
+  # 要素をエンキュー
+  deque.push_last(4)
+  puts "要素 4 を末尾に追加後 deque = #{deque.to_array}"
+  deque.push_first(1)
+  puts "要素 1 を先頭に追加後 deque = #{deque.to_array}"
+
+  # 要素をデキュー
+  pop_last = deque.pop_last
+  puts "末尾から取り出した要素 = #{pop_last}, 末尾から取り出した後 deque = #{deque.to_array}"
+  pop_first = deque.pop_first
+  puts "先頭から取り出した要素 = #{pop_first}，先頭から取り出した後 deque = #{deque.to_array}"
+
+  # 両端キューの長さを取得
+  size = deque.size
+  puts "両端キューの長さ size = #{size}"
+
+  # 両端キューが空かどうかを判定
+  is_empty = deque.is_empty?
+  puts "両端キューが空かどうか = #{is_empty}"
+end

ja/codes/ruby/chapter_stack_and_queue/linkedlist_queue.rb

@@ -0,0 +1,101 @@
+=begin
+File: linkedlist_queue.rb
+Created Time: 2024-04-06
+Author: Xuan Khoa Tu Nguyen (ngxktuzkai2000@gmail.com)
+=end
+
+require_relative '../utils/list_node'
+
+### 連結リストで実装したキュー ###
+class LinkedListQueue
+  ### キューの長さを取得 ###
+  attr_reader :size
+
+  ### コンストラクタ ###
+  def initialize
+    @front = nil  # 先頭ノード front
+    @rear = nil   # 末尾ノード rear
+    @size = 0
+  end
+
+  ### キューが空か判定 ###
+  def is_empty?
+    @front.nil?
+  end
+
+  ### エンキュー ###
+  def push(num)
+    # 末尾ノードの後ろに num を追加
+    node = ListNode.new(num)
+
+    # キューが空なら、先頭ノードと末尾ノードの両方をそのノードに向ける
+    if @front.nil?
+      @front = node
+      @rear = node
+    # キューが空でなければ、そのノードを末尾ノードの後ろに追加する
+    else
+      @rear.next = node
+      @rear = node
+    end
+
+    @size += 1
+  end
+
+  ### デキュー ###
+  def pop
+    num = peek
+    # 先頭ノードを削除
+    @front = @front.next
+    @size -= 1
+    num
+  end
+
+  ### 先頭要素にアクセス ###
+  def peek
+    raise IndexError, 'キューは空です' if is_empty?
+
+    @front.val
+  end
+
+  ### 連結リストを Array に変換して返す ###
+  def to_array
+    queue = []
+    temp = @front
+    while temp
+      queue << temp.val
+      temp = temp.next
+    end
+    queue
+  end
+end
+
+### Driver Code ###
+if __FILE__ == $0
+  # キューを初期化
+  queue = LinkedListQueue.new
+
+  # 要素をキューに入れる
+  queue.push(1)
+  queue.push(3)
+  queue.push(2)
+  queue.push(5)
+  queue.push(4)
+  puts "キュー queue = #{queue.to_array}"
+
+  # キュー先頭の要素にアクセス
+  peek = queue.peek
+  puts "先頭要素 front = #{peek}"
+
+  # 要素をデキュー
+  pop_front = queue.pop
+  puts "取り出した要素 pop = #{pop_front}"
+  puts "取り出し後 queue = #{queue.to_array}"
+
+  # キューの長さを取得
+  size = queue.size
+  puts "キューの長さ size = #{size}"
+
+  # キューが空かどうかを判定
+  is_empty = queue.is_empty?
+  puts "キューが空かどうか = #{is_empty}"
+end

ja/codes/ruby/chapter_stack_and_queue/linkedlist_stack.rb

@@ -0,0 +1,87 @@
+=begin
+File: linkedlist_stack.rb
+Created Time: 2024-04-06
+Author: Xuan Khoa Tu Nguyen (ngxktuzkai2000@gmail.com)
+=end
+
+require_relative '../utils/list_node'
+
+### 連結リストで実装したスタック ###
+class LinkedListStack
+  attr_reader :size
+
+  ### コンストラクタ ###
+  def initialize
+    @size = 0
+  end
+
+  ### スタックが空か判定 ###
+  def is_empty?
+    @peek.nil?
+  end
+
+  ### プッシュ ###
+  def push(val)
+    node = ListNode.new(val)
+    node.next = @peek
+    @peek = node
+    @size += 1
+  end
+
+  ### ポップ ###
+  def pop
+    num = peek
+    @peek = @peek.next
+    @size -= 1
+    num
+  end
+
+  ### スタックトップ要素を参照 ###
+  def peek
+    raise IndexError, 'スタックは空です' if is_empty?
+
+    @peek.val
+  end
+
+  ### 連結リストを Array に変換して返す ###
+  def to_array
+    arr = []
+    node = @peek
+    while node
+      arr << node.val
+      node = node.next
+    end
+    arr.reverse
+  end
+end
+
+### Driver Code ###
+if __FILE__ == $0
+  # スタックを初期化
+  stack = LinkedListStack.new
+
+  # 要素をプッシュ
+  stack.push(1)
+  stack.push(3)
+  stack.push(2)
+  stack.push(5)
+  stack.push(4)
+  puts "スタック stack = #{stack.to_array}"
+
+  # スタックトップの要素にアクセス
+  peek = stack.peek
+  puts "スタックトップ要素 peek = #{peek}"
+
+  # 要素をポップ
+  pop = stack.pop
+  puts "ポップした要素 pop = #{pop}"
+  puts "ポップ後 stack = #{stack.to_array}"
+
+  # スタックの長さを取得
+  size = stack.size
+  puts "スタックの長さ size = #{size}"
+
+  # 空かどうかを判定
+  is_empty = stack.is_empty?
+  puts "スタックが空かどうか = #{is_empty}"
+end

ja/codes/ruby/chapter_stack_and_queue/queue.rb

@@ -0,0 +1,38 @@
+=begin
+File: queue.rb
+Created Time: 2024-04-06
+Author: Xuan Khoa Tu Nguyen (ngxktuzkai2000@gmail.com)
+=end
+
+### Driver Code ###
+if __FILE__ == $0
+  # キューを初期化する
+  # Ruby 組み込みのキュー（Thread::Queue）には peek と走査メソッドがないため、Array をキューとして使える
+  queue = []
+
+  # 要素をエンキュー
+  queue.push(1)
+  queue.push(3)
+  queue.push(2)
+  queue.push(5)
+  queue.push(4)
+  puts "キュー queue = #{queue}"
+
+  # キューの要素にアクセス
+  peek = queue.first
+  puts "先頭要素 peek = #{peek}"
+
+  # 要素をキューから取り出す
+  # 配列であるため、Array#shift メソッドの時間計算量は O(n) である
+  pop = queue.shift
+  puts "取り出した要素 pop = #{pop}"
+  puts "取り出し後 queue = #{queue}"
+
+  # キューの長さを取得
+  size = queue.length
+  puts "キューの長さ size = #{size}"
+
+  # キューが空かどうかを判定
+  is_empty = queue.empty?
+  puts "キューが空かどうか = #{is_empty}"
+end

ja/codes/ruby/chapter_stack_and_queue/stack.rb

@@ -0,0 +1,37 @@
+=begin
+File: stack.rb
+Created Time: 2024-04-06
+Author: Xuan Khoa Tu Nguyen (ngxktuzkai2000@gmail.com)
+=end
+
+### Driver Code ###
+if __FILE__ == $0
+  # スタックを初期化する
+  # Ruby には組み込みのスタッククラスがないため、Array をスタックとして使える
+  stack = []
+
+  # 要素をプッシュ
+  stack << 1
+  stack << 3
+  stack << 2
+  stack << 5
+  stack << 4
+  puts "スタック stack = #{stack}"
+
+  # スタックトップの要素にアクセス
+  peek = stack.last
+  puts "スタックトップ要素 peek = #{peek}"
+
+  # 要素をポップ
+  pop = stack.pop
+  puts "ポップした要素 pop = #{pop}"
+  puts "ポップ後 stack = #{stack}"
+
+  # スタックの長さを取得
+  size = stack.length
+  puts "スタックの長さ size = #{size}"
+
+  # 空かどうかを判定
+  is_empty = stack.empty?
+  puts "スタックが空かどうか = #{is_empty}"
+end