Enumerable.find / find_all / detect

# 条件に一致する最初の要素を返します。
コレクション.find { |要素| 条件 }
コレクション.detect { |要素| 条件 }  # find の別名

# 条件に一致するすべての要素を配列で返します。
コレクション.find_all { |要素| 条件 }
コレクション.select { |要素| 条件 }   # find_all の別名

# 条件に一致しない要素をすべて返します。
コレクション.reject { |要素| 条件 }

sample_enumerable_find_find_all.rb

numbers = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]

# 最初の偶数を検索します。
first_even = numbers.find { |n| n.even? }
puts first_even  # 2

# 一致しない場合は nil が返ります。
large = numbers.find { |n| n > 100 }
puts large.nil?  # true

# すべての偶数を取得します。
evens = numbers.find_all { |n| n.even? }
puts evens.inspect  # [2, 4, 6, 8, 10]

# ハッシュの配列から条件で絞り込みます。
users = [
  { name: "孫悟空", age: 23, org: "カプセルコーポレーション" },
  { name: "ベジータ", age: 29, org: "カプセルコーポレーション" },
  { name: "ブルマ", age: 28, org: "カプセルコーポレーション" },
  { name: "クリリン", age: 25, org: "亀仙流" }
]

# 25歳以上のメンバーを find_all で取得します。
veterans = users.find_all { |u| u[:age] >= 25 }
puts veterans.map { |u| u[:name] }.inspect  # ["ベジータ", "ブルマ", "クリリン"]

ruby enumerable_find_find_all.rb
2
true
[2, 4, 6, 8, 10]
["ベジータ", "ブルマ", "クリリン"]

『find』と『find_all』はEnumerableモジュールのメソッドで、配列やハッシュなどあらゆるコレクションで使用できます。『find』は最初の一致要素のみを返すため、存在確認や1件取得に適しています。

『select』は『find_all』の別名として広く使われており、実際のコードでは『select』のほうが多く見られます。条件に一致しない要素を除外する場合は『reject』が直感的に書けます。『find』で一致しない場合は『nil』が返るため、戻り値を使う前に『nil?』や『&.』（ぼっち演算子）でチェックすることをお勧めします。