Ruby 1.9.2 リファレンスマニュアル > ライブラリ一覧 > library _builtin > class IO > foreach

singleton method IO.foreach

foreach(path, rs = $/) {|line| ... } -> nil

foreach(path, rs = $/) -> Enumerable::Enumerator

path で指定されたファイルの各行を引数としてブロックを繰り返し実行します。 path のオープンに成功すれば nil を返します。

ブロックが与えられなかった場合は、path で指定されたファイルの各行を繰り返す Enumerable::Enumerator オブジェクトを生成して返します。

テキスト読み込みメソッドとして動作します。 path が空ファイルの場合、何もせずに nil を返します。 Kernel.#open と同様 path の先頭が "|" ならば、"|" に続くコマンドの出力を読み取ります。

[PARAM] path:

ファイル名を表す文字列か "|コマンド名" を指定します。

[PARAM] rs:

行の区切りを文字列で指定します。rs に nil を指定すると行区切りなしとみなします。 空文字列 "" を指定すると連続する改行を行の区切りとみなします(パラグラフモード)。

[EXCEPTION] Errno::EXXX:

path のオープンに失敗した場合、発生します。

[SEE_ALSO] $/