Type:
Class

Zlib::GzipReader is the class for reading a gzipped file. GzipReader should be used an IO, or -IO-like, object.

Zlib::GzipReader.open('hoge.gz') {|gz|
  print gz.read
}

File.open('hoge.gz') do |f|
  gz = Zlib::GzipReader.new(f)
  print gz.read
  gz.close
end

Method Catalogue

The following methods in Zlib::GzipReader are just like their counterparts in IO, but they raise Zlib::Error or Zlib::GzipFile::Error exception if an error was found in the gzip file.

Be careful of the footer of the gzip file. A gzip file has the checksum of pre-compressed data in its footer. GzipReader checks all uncompressed data against that checksum at the following cases, and if it fails, raises Zlib::GzipFile::NoFooter, Zlib::GzipFile::CRCError, or Zlib::GzipFile::LengthError exception.

  • When an reading request is received beyond the end of file (the end of compressed data). That is, when #read, #gets, or some other methods for reading returns nil.

  • When Zlib::GzipFile#close method is called after the object reaches the end of file.

  • When #unused method is called after the object reaches the end of file.

The rest of the methods are adequately described in their own documentation.

read

read(p1 = v1) Instance Public methods See

2015-06-14 17:16:17
getbyte

getbyte() Instance Public methods See

2015-06-14 16:38:58
readchar

readchar() Instance Public methods See

2015-06-14 17:23:12
getc

getc() Instance Public methods See

2015-06-14 16:46:13
lineno=

lineno=(p1) Instance Public methods Specify line number of the last row read

2015-06-14 17:04:13
eof

eof() Instance Public methods Returns true or false

2015-06-14 16:28:38
readline

readline(*args) Instance Public methods See

2015-06-14 17:30:17
unused

unused() Instance Public methods Returns the rest of the data which had read

2015-06-14 17:56:44
each

each(*args) Instance Public methods See

2015-06-14 16:12:56
each_line

each_line(*args) Instance Public methods See

2015-06-14 16:22:11