names=gets
visibility=public
kind=defined

--- gets(rs = $/)    -> String | nil
--- gets(limit) -> String | nil
--- gets(rs, limit) -> String | nil


一行読み込んで、読み込みに成功した時にはその文字列を返します。
EOF に到達した時には nil を返します。

テキスト読み込みメソッドとして動作します。
読み込んだ文字列を変数 [[m:$_]] にセットします。
[[m:IO#readline]] との違いは EOF での振る舞いのみです。

limit で最大の読み込みバイト数を指定します。ただし
ファイルのエンコーディングがマルチバイトエンコーディングである場合には
読み込んだ文字列がマルチバイト文字の途中で切れないように
数バイト余分に読み込む場合があります。

@param rs 行の区切りを文字列で指定します。rs に nil を指定すると行区切りなしとみなします。
          空文字列 "" を指定すると連続する改行を行の区切りとみなします(パラグラフモード)。
@param limit 最大の読み込みバイト数

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

   f = File.new("oneline_file")
   f.gets                          #=> "This is line one\n"
   $_                              #=> "This is line one\n"
   f.gets                          #=> nil
   $_                              #=> nil

@see [[m:$/]], [[m:IO#readline]]

