Ruby 1.9.3 リファレンスマニュアル > ライブラリ一覧 > zlibライブラリ > Zlib::GzipReaderクラス > readline

instance method Zlib::GzipReader#readline

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

IO クラスの同名メソッドIO#readlineと同じです。

但し、gzip ファイル中に エラーがあった場合 Zlib::Error 例外や Zlib::GzipFile::Error 例外が発生します。

gzip ファイルのフッターの処理に注意して下さい。 gzip ファイルのフッターには圧縮前データのチェックサムが 記録されています。GzipReader オブジェクトは、次の時に展開した データとフッターの照合を行い、エラーがあった場合は Zlib::GzipFile::NoFooter, Zlib::GzipFile::CRCError, Zlib::GzipFile::LengthError 例外を発生させます。

• EOF (圧縮データの最後) を越えて読み込み要求を受けた時。 すなわち Zlib::GzipReader#read, Zlib::GzipReader#gets メソッド等が nil を返す時。
• EOF まで読み込んだ後、Zlib::GzipFile#close メソッドが 呼び出された時。
• EOF まで読み込んだ後、Zlib::GzipReader#unused メソッドが 呼び出された時。

[PARAM] rs:

行の区切りを文字列で指定します。

[EXCEPTION] EOFError:

EOF に到達したとき発生します。

[EXCEPTION] Zlib::Error:

Zlib::Error を参照

[EXCEPTION] Zlib::GzipFile::Error:

Zlib::GzipFile::Errorを参照

[EXCEPTION] Zlib::GzipFile::NoFooter:

Zlib::GzipFile::NoFooterを参照

[EXCEPTION] Zlib::GzipFile::CRCError:

Zlib::GzipFile::CRCErrorを参照

[EXCEPTION] Zlib::GzipFile::LengthError:

Zlib::GzipFile::LengthErrorを参照

=begin
# hoge.gz がない場合は下記で作成できる。
Zlib::GzipWriter.open('hoge.gz') { |gz|
  gz.puts 'hoge'
  gz.puts 'fuga'
}
=end

Zlib::GzipReader.open('hoge.gz') { |gz|
  begin
    puts gz.readline
  rescue EOFError => err
    puts err
    break
  end while true
}
#=> hoge
#=> fuga
#=> end of file reached

[SEE_ALSO] IO#readline