Re-translate the Japanese version (#1871)

* Retranslate Japanese docs with GPT-5.4

* Retranslate Japanese code with GPT-5.4

ja/codes/ruby/utils/list_node.rb

@@ -0,0 +1,38 @@
+=begin
+File: list_node.rb
+Created Time: 2024-03-18
+Author: Xuan Khoa Tu Nguyen (ngxktuzkai2000@gmail.com)
+=end
+
+### 連結リストノードクラス ###
+class ListNode
+  attr_accessor :val  # ノード値
+  attr_accessor :next # 次のノードへの参照
+
+  def initialize(val=0, next_node=nil)
+    @val = val
+    @next = next_node
+  end
+end
+
+### リストを連結リストにデシリアライズ ###
+def arr_to_linked_list(arr)
+  head = current = ListNode.new(arr[0])
+
+  for i in 1...arr.length
+    current.next = ListNode.new(arr[i])
+    current = current.next
+  end
+
+  head
+end
+
+### 連結リストをリストにシリアライズ ###
+def linked_list_to_arr(head)
+  arr = []
+
+  while head
+    arr << head.val
+    head = head.next
+  end
+end

ja/codes/ruby/utils/print_util.rb

@@ -0,0 +1,80 @@
+=begin
+File: print_util.rb
+Created Time: 2024-03-18
+Author: Xuan Khoa Tu Nguyen (ngxktuzkai2000@gmail.com)
+=end
+
+require_relative "./tree_node"
+
+### 行列を出力 ###
+def print_matrix(mat)
+  s = []
+  mat.each { |arr| s << " #{arr.to_s}" }
+  puts "[\n#{s.join(",\n")}\n]"
+end
+
+### 連結リストを出力 ###
+def print_linked_list(head)
+  list = []
+  while head
+    list << head.val
+    head = head.next
+  end
+  puts "#{list.join(" -> ")}"
+end
+
+class Trunk
+  attr_accessor :prev, :str
+
+  def initialize(prev, str)
+    @prev = prev
+    @str = str
+  end
+end
+
+def show_trunk(p)
+  return if p.nil?
+
+  show_trunk(p.prev)
+  print p.str
+end
+
+### 二分木を出力 ###
+# This tree printer is borrowed from TECHIE DELIGHT
+# https://www.techiedelight.com/c-program-print-binary-tree/
+def print_tree(root, prev=nil, is_right=false)
+  return if root.nil?
+
+  prev_str = "    "
+  trunk = Trunk.new(prev, prev_str)
+  print_tree(root.right, trunk, true)
+
+  if prev.nil?
+    trunk.str = "———"
+  elsif is_right
+    trunk.str = "/———"
+    prev_str = "   |"
+  else
+    trunk.str = "\\———"
+    prev.str = prev_str
+  end
+
+  show_trunk(trunk)
+  puts " #{root.val}"
+  prev.str = prev_str if prev
+  trunk.str = "   |"
+  print_tree(root.left, trunk, false)
+end
+
+### ハッシュテーブルを出力 ###
+def print_hash_map(hmap)
+  hmap.entries.each { |key, value| puts "#{key} -> #{value}" }
+end
+
+### ヒープを出力 ###
+def print_heap(heap)
+  puts "ヒープの配列表現：#{heap}"
+  puts "ヒープの木構造表現："
+  root = arr_to_tree(heap)
+  print_tree(root)
+end

ja/codes/ruby/utils/tree_node.rb

@@ -0,0 +1,53 @@
+=begin
+File: tree_node.rb
+Created Time: 2024-03-30
+Author: Xuan Khoa Tu Nguyen (ngxktuzkai2000@gmail.com)
+=end
+
+### 二分木ノードクラス ###
+class TreeNode
+  attr_accessor :val    # ノード値
+  attr_accessor :height # ノードの高さ
+  attr_accessor :left   # 左子ノードへの参照
+  attr_accessor :right  # 右子ノードへの参照
+
+  def initialize(val=0)
+    @val = val
+    @height = 0
+  end
+end
+
+### リストを二分木にデシリアライズ：再帰 ###
+def arr_to_tree_dfs(arr, i)
+  # 添字が配列長を超えるか、対応する要素が nil なら、nil を返す
+  return if i < 0 || i >= arr.length || arr[i].nil?
+  # 現在のノードを構築する
+  root = TreeNode.new(arr[i])
+  # 左右の部分木を再帰的に構築する
+  root.left = arr_to_tree_dfs(arr, 2 * i + 1)
+  root.right = arr_to_tree_dfs(arr, 2 * i + 2)
+  root
+end
+
+### リストを二分木にデシリアライズ ###
+def arr_to_tree(arr)
+  arr_to_tree_dfs(arr, 0)
+end
+
+### 二分木をリストにシリアライズ：再帰 ###
+def tree_to_arr_dfs(root, i, res)
+  return if root.nil?
+
+  res += Array.new(i - res.length + 1) if i >= res.length
+  res[i] = root.val
+
+  tree_to_arr_dfs(root.left, 2 * i + 1, res)
+  tree_to_arr_dfs(root.right, 2 * i + 2, res)
+end
+
+### 二分木をリストにシリアライズ ###
+def tree_to_arr(root)
+  res = []
+  tree_to_arr_dfs(root, 0, res)
+  res
+end

ja/codes/ruby/utils/vertex.rb

@@ -0,0 +1,24 @@
+=begin
+File: vertex.rb
+Created Time: 2024-04-25
+Author: Xuan Khoa Tu Nguyen (ngxktuzkai2000@gmail.com)
+=end
+
+### 頂点クラス ###
+class Vertex
+  attr_accessor :val
+
+  def initialize(val)
+    @val = val
+  end
+end
+
+### 値リスト vals を入力し、頂点リスト vets を返す ###
+def vals_to_vets(vals)
+  Array.new(vals.length) { |i| Vertex.new(vals[i]) }
+end
+
+### 頂点リスト vets を入力し、値リスト vals を返す ###
+def vets_to_vals(vets)
+  Array.new(vets.length) { |i| vets[i].val }
+end