Webエンジニア向けプログラミング解説動画をYouTubeで配信中!
▶ チャンネル登録はこちら

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

next_valuesメソッドの使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

next_valuesメソッドは、RubyのEnumeratorオブジェクトが、繰り返し処理の中で次に生成する複数の値を配列として取り出すメソッドです。Enumeratorは、配列の要素を一つずつ順番に処理するeachメソッドのように、繰り返し処理の進行状況を管理し、必要な時に次のデータを取り出すための仕組みを提供します。このnext_valuesメソッドは、例えばeach_with_indexのように、繰り返しの各ステップで要素とそのインデックスといった複数の値を同時に生成するような場合に特に有用です。

呼び出すたびに、次にブロックに渡されるはずの複数の値がまとめて配列として返されます。これにより、繰り返し処理の流れを一時的に中断し、外部からその時点での次のデータセットを確認・取得することが可能になります。一方、nextメソッドは単一の値のみを返します。もし、これ以上取得すべき値がない状態でnext_valuesを呼び出すと、繰り返しが終了したことを示すStopIteration例外が発生します。また、rewindメソッドを使用することで、Enumeratorの状態を最初の位置に戻し、最初から値を取得し直すこともできます。

構文(syntax)

1enum = Enumerator.new do |y|
2  y.yield 1, 2
3  y.yield 3
4end
5
6enum.next_values

引数(parameters)

引数なし

引数はありません

戻り値(return)

Array

Enumeratorオブジェクトが保持する次の要素を配列として返します。Enumeratorが終了している場合は、StopIteration例外を発生させます。

関連コンテンツ