Ruby ハッシュトラバースとデータ抽出

JPKODA 編集部 May 10, 2026

ハッシュ (Hash) はRubyにおいて、ユニークな「キー (Key)」を介してデータを高効率にオーガナイズし、アクセスするためのアプローチを提供します。

本章では、ハッシュを操作する際に最も頻繁にユースされ、かつ実用的なコアメソッドである keys、values、each についてディープダイブします。これらのメソッドは、ハッシュデータを自由にトラバース (Traverse) し、トランスフォーム (Transform) するための強力なケーパビリティをデベロッパーに付与します。

1. keys を使用したすべてのキーの抽出

keys メソッドは、指定されたハッシュ内のすべてのキー (Keys) を含む新しい配列 (Array) をリターンします。すべてのキーをトラバースする必要がある場合、特定のキーが存在するかどうかをチェックする場合、あるいはキーのリストを要求するその他のオペレーションを実行する場合に、このメソッドは非常に有用です。

1.1 ベーシックなユースケース

# サンプルのハッシュを作成
student = {
  "name" => "Alice",
  "age" => 20,
  "major" => "Computer Science"
}

# すべてのキーを抽出
keys_array = student.keys

# キーの配列をプリント
puts keys_array.inspect  # 出力: ["name", "age", "major"]

この例では、student ハッシュに対して keys メソッドをコールしています。リターンされた配列 keys_array には、文字列 (String) の "name"、"age"、"major" が含まれており、これらはまさに該当ハッシュのキーです。inspect メソッドは、配列のコンテンツをヒューマンリーダブル (Human-readable) なフォーマットでディスプレイするためにユースされます。

1.2 実践的なユースケース

ウェブサイトのコンフィグレーション・セッティング (Configuration setting) を表現するハッシュがあると仮定します。

website_config = {
  "title" => "My Awesome Website",
  "theme" => "dark",
  "posts_per_page" => 10,
  "enable_comments" => true
}

# すべてのコンフィグレーションのキーを取得
config_keys = website_config.keys
puts "コンフィグレーション項目: #{config_keys.join(', ')}"
# 出力: コンフィグレーション項目: title, theme, posts_per_page, enable_comments

この例は、keys メソッドを使用して、ウェブサイトで利用可能なすべてのコンフィグレーション項目をリトリーブ (Retrieve) する方法を示しています。その後、join(', ') メソッドを使用して、これらのキーをカンマ区切りの文字列に結合 (Join) してディスプレイしています。

1.3 アドバンスドなユースケースと留意点

keys メソッドによってリターンされた配列は、他の配列メソッドと組み合わせて、より複雑なオペレーションを実行することができます。例えば、ハッシュ内に特定のキーが存在するかどうかをチェックできます。

website_config = {
  "title" => "My Awesome Website",
  "theme" => "dark",
  "posts_per_page" => 10,
  "enable_comments" => true
}

# 特定のキーが存在するかチェック
if website_config.keys.include?("theme")
  puts "現在のテーマ設定: #{website_config["theme"]}" # 出力: 現在のテーマ設定: dark
else
  puts "テーマは未設定です。"
end

このコードは、keys がリターンした配列に対して include? メソッドを使用し、website_config ハッシュ内に特定のキー（この例では "theme"）が存在するかどうかを検証 (Verify) する方法をデモンストレーションしています。

2. values を使用したすべての値の抽出

values メソッドは、指定されたハッシュ内のすべての値 (Values) を含む新しい配列をリターンします。キーとは独立してこれらの値を処理したい場合に、このメソッドは非常に役立ちます。

2.1 ベーシックなユースケース

# サンプルのハッシュを作成
product = {
  "name" => "Laptop",
  "price" => 1200,
  "brand" => "XYZ Corp"
}

# すべての値を抽出
values_array = product.values

# 値の配列をプリント
puts values_array.inspect # 出力: ["Laptop", 1200, "XYZ Corp"]

この例では、product ハッシュに対して values メソッドをコールしています。リターンされた配列 values_array には、文字列 "Laptop"、"XYZ Corp"、および整数 1200 が含まれており、これらはまさにハッシュ内の値です。

2.2 実践的なユースケース

学生の各科目のスコアをストアしているハッシュがあるシナリオを想定します。

student_scores = {
  "Math" => 95,
  "Science" => 88,
  "English" => 92
}

# すべてのスコアを取得
scores = student_scores.values
puts "学生のスコアリスト: #{scores.join(', ')}"
# 出力: 学生のスコアリスト: 95, 88, 92

# 平均スコアを計算
total = scores.sum
average = total.to_f / scores.length
puts "平均スコア: #{average}" # 出力: 平均スコア: 91.66666666666667

この例は、values メソッドを使用して student_scores ハッシュからスコアデータを抽出する方法を示しています。その後、スコアのトータル (Total) をスコアのカウント数で除算することで、平均スコアを計算しています。

2.3 アドバンスドなユースケースと留意点

keys と同様に、values メソッドがリターンする配列も、他の配列メソッドと連携してデータ分析やデータ操作 (Data manipulation) を行うことができます。例えば、最高スコアをファインド (Find) することができます。

student_scores = {
  "Math" => 95,
  "Science" => 88,
  "English" => 92
}

# 最高スコアをファインド
highest_score = student_scores.values.max
puts "最高スコア: #{highest_score}" # 出力: 最高スコア: 95

このコードは、values がリターンした配列に対してビルトイン (Built-in) の max メソッドを使用し、student_scores ハッシュから最高スコアをイージーに特定する方法をデモンストレーションしています。

3. each を使用したハッシュのトラバース

each メソッドを使用すると、ハッシュ内のすべてのKey-Valueペアをトラバース（イテレーション）できます。このメソッドはブロック (Block) をレシーブ (Receive) し、各Key-Valueペアに対してそのブロックを実行すると同時に、キーと値へのアクセス権をプロバイド (Provide) します。これはハッシュ内の各要素に対してオペレーションを実行するための極めてパワフルなツールです。

3.1 ベーシックなユースケース

# サンプルのハッシュを作成
employee = {
  "name" => "Bob",
  "title" => "Software Engineer",
  "salary" => 80000
}

# each を使用してハッシュをトラバース
employee.each do |key, value|
  puts "キー: #{key}, 値: #{value}"
end

# 出力:
# キー: name, 値: Bob
# キー: title, 値: Software Engineer
# キー: salary, 値: 80000

この例では、employee ハッシュに対して each メソッドをコールしています。ブロック do |key, value| ... end は、ハッシュ内の各Key-Valueペアに対して1回ずつ実行 (Execute) されます。ブロックの内部では、key 変数が現在のキーを保持し、value 変数が対応する値を保持します。

3.2 実践的なユースケース

ハッシュにストアされたデータをフォーマットし、ディスプレイする必要があるシナリオを考えます。

book = {
  "title" => "The Ruby Way",
  "author" => "Hal Fulton",
  "pages" => 450
}

# 書籍情報をフォーマットしてディスプレイ
book.each do |key, value|
  puts "#{key.capitalize}: #{value}"
end

# 出力:
# Title: The Ruby Way
# Author: Hal Fulton
# Pages: 450

この例では、each を使用して book ハッシュをトラバースし、各Key-Valueペアをフォーマットされた状態でディスプレイする方法を示しています。ここでは、リーダビリティ (Readability) を向上させるために、capitalize メソッドを使用してキーの最初の文字を大文字にトランスフォームしています。

3.3 アドバンスドなユースケースと留意点

each メソッドは、ループ (Loop) 内でより複雑な条件ロジック (Conditional logic) を実行することが可能です。例えば、特定のKey-Valueペアを条件付きでハンドリング (Handle) することができます。

product = {
  "name" => "Laptop",
  "price" => 1200,
  "brand" => "XYZ Corp",
  "discount" => 0.1
}

# ディスカウントが存在する場合、それを適用
product.each do |key, value|
  if key == "price"
    discount = product["discount"] || 0
    discounted_price = value * (1 - discount)
    puts "ディスカウント後の価格: #{discounted_price}" # 出力: ディスカウント後の価格: 1080.0
  else
    puts "キー: #{key}, 値: #{value}"
  end
end

# 完全な出力結果:
# キー: name, 値: Laptop
# ディスカウント後の価格: 1080.0
# キー: brand, 値: XYZ Corp
# キー: discount, 値: 0.1

このコードは、product ハッシュ内の "price" キーに対して条件付きのハンドリングを行う方法をデモンストレーションしています。"discount" キーが存在するかどうかをチェックし、存在する場合はディスカウント適用後の価格を計算 (Calculate) しています。