instance method Zlib::GzipReader#each_byte

each_byte {|byte| ... } -> nil[permalink][rdoc]

each_byte -> Enumerator

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

但し、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 メソッドが呼び出された時。

[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を参照

require 'zlib'

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

Zlib::GzipReader.open('hoge.gz') { |gz|
  gz.each_byte { |b|
    printf "%d -> %c\n", b, b
  }
}
#=> 104 -> h
#=> 111 -> o
#=> 103 -> g
#=> 101 -> e
#=> 10 ->

[SEE_ALSO] IO#each_byte