Rubyリファレンス: Home

first (Enumerable)

Edit   History

Ruby 1.8.7 Ruby 1.9

標準クラス・モジュール > Array > first

enum.first
enum.first(num)

firstメソッドは、先頭の要素を返します。要素が1つもないときはnilを返します。

次の例は、ファイルの最初の行を表示します。

File.open("temp.txt") {|file| puts file.first }
one   (ファイルにより結果は変わります)

引数numに整数を指定すると、先頭からその数だけ要素を取り出して、配列にして返します。要素が1つもないときは空の配列を返します。

次の例は、ファイルの最初の3行を表示します。

File.open("temp.txt") {|file| puts file.first(3) }
one
two
three   (ファイルにより結果は変わります)

メモ

「先頭」とは、実際には要素を1回あるいはnum回だけ繰り返し取り出すことです。Ruby 1.8のハッシュのように順序を持たない集合でも、firstメソッドを利用できます。

関連項目