【Ruby3.x】Array::first()メソッドの使い方

firstメソッドは、レシーバであるArrayオブジェクトの要素にアクセスするために使用されるメソッドです。

このメソッドを引数なしで呼び出すと、配列の最初の要素を返します。配列が空である場合はnilを返します。例えば、[10, 20, 30].firstと記述すると、数値の10が戻り値となります。空の配列[]に対してfirstを呼び出した場合はnilが返されます。

また、firstメソッドは整数を引数として受け入れることもできます。引数に整数nを渡すと、配列の先頭からn個の要素を格納した新しい配列を返します。例えば、["a", "b", "c", "d"].first(2)は["a", "b"]という配列を返します。指定した個数nが配列の実際の要素数よりも大きい場合でもエラーにはならず、配列のすべての要素を含む新しい配列が返されます。もし引数nに0を指定した場合は、要素を含まない空の配列[]が戻り値となります。

このfirstメソッドは、元の配列の内容を一切変更しない非破壊的なメソッドです。そのため、配列の安全な操作が保証され、元のデータ構造を保ちながら必要な要素だけを取り出すことができます。プログラム内で配列の先頭要素や、冒頭の複数要素を手軽に取得したい場合に非常に有用であり、データの抽出や特定の範囲の処理など、様々なシナリオで活用できる基本的なメソッドです。

Copy
1[1, 2, 3].first

n = nil

• n: 取得する要素数を指定する整数（省略時は1つ）

Object | nil | Array

配列の最初の要素を返します。配列が空の場合はnilを返します。整数を指定すると、最初のn個の要素を配列として返します。