Ruby 1.9.3 リファレンスマニュアル > ライブラリ一覧 > stringioライブラリ > StringIOクラス > readline

instance method StringIO#readline

readline(rs = $/) -> String[permalink][rdoc]

自身から 1 行読み込んで、その文字列を返します。

文字列の終端に到達した時には、例外 EOFError を発生させます。 IO#readline と違い読み込んだ文字列を変数 $_ にセットしません。

[PARAM] rs:

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

[EXCEPTION] EOFError:

文字列の終端に到達した時に発生します。

[EXCEPTION] IOError:

自身が読み込み用にオープンされていなければ発生します。

a = StringIO.new("hoge\nfoo\nbar\n")
a.readline                           #=> "hoge\n"
a.readline(nil)                      #=> "foo\nbar\n"
a.readline                           #=> EOFError が発生する

[SEE_ALSO] $/