ꦫꦣꦺꦤ꧀ꦄꦤ꧀ꦠꦱꦺꦤ

PATH: opt / alt / ruby34 / share / gems / gems / rbs-3.8.0 / stdlib / zlib / 0

%a{annotate:rdoc:skip}
module Zlib
  # 
  # Zlib::GzipReader is the class for reading a gzipped file.  GzipReader should
  # be used as 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.
  # *   #each
  # *   #each_line
  # *   #each_byte
  # *   #gets
  # *   #getc
  # *   #lineno
  # *   #lineno=
  # *   #read
  # *   #readchar
  # *   #readline
  # *   #readlines
  # *   #ungetc
  #
  # 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 Zlib::GzipReader#read,
  #     Zlib::GzipReader#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 Zlib::GzipReader#unused method is called after the object reaches the
  #     end of file.
  #
  # The rest of the methods are adequately described in their own documentation.
  #
  class GzipReader < Zlib::GzipFile
    include Enumerable[String]

def self.wrap: (IO io) -> instance
                 | (IO io) { (instance gz) -> void } -> void

# 
    # Opens a file specified by `filename` as a gzipped file, and returns a
    # GzipReader object associated with that file.  Further details of this method
    # are in Zlib::GzipReader.new and ZLib::GzipFile.wrap.
    #
    def self.open: (String | _ToPath filename) -> instance
                 | (String | _ToPath filename) { (instance gz) -> void } -> void

# 
    # Decompresses all gzip data in the `io`, handling multiple gzip streams until
    # the end of the `io`.  There should not be any non-gzip data after the gzip
    # streams.
    #
    # If a block is given, it is yielded strings of uncompressed data, and the
    # method returns `nil`. If a block is not given, the method returns the
    # concatenation of all uncompressed data in all gzip streams.
    #
    def self.zcat: (IO io, **untyped) -> String
                 | (IO io, **untyped) { (String chunk) -> void } -> nil

# 
    # See Zlib::GzipReader documentation for a description.
    #
    def each: (*untyped) { (String) -> void } -> void

# 
    # See Zlib::GzipReader documentation for a description.
    #
    def each_byte: () { (String) -> void } -> void

# 
    # See Zlib::GzipReader documentation for a description.
    #
    def each_char: () { (String) -> void } -> void

# 
    # See Zlib::GzipReader documentation for a description.
    #
    def each_line: (*untyped) { (String) -> void } -> void

# 
    # Returns `true` or `false` whether the stream has reached the end.
    #
    def eof: () -> bool

# 
    # Returns `true` or `false` whether the stream has reached the end.
    #
    def eof?: () -> bool

# 
    # See Zlib::GzipReader documentation for a description.
    #
    def external_encoding: () -> Encoding

# 
    # See Zlib::GzipReader documentation for a description.
    #
    def getbyte: () -> Integer?

# 
    # See Zlib::GzipReader documentation for a description.
    #
    def getc: () -> String?

# 
    # See Zlib::GzipReader documentation for a description. However, note that this
    # method can return `nil` even if #eof? returns false, unlike the behavior of
    # File#gets.
    #
    def gets: (?String sep, ?Integer limit) -> String?

# 
    # The line number of the last row read from this file.
    #
    def lineno: () -> Integer

# 
    # Specify line number of the last row read from this file.
    #
    def lineno=: (Integer arg0) -> Integer

# 
    # Total number of output bytes output so far.
    #
    def pos: () -> Integer

# 
    # See Zlib::GzipReader documentation for a description.
    #
    def read: (?int? length, ?string outbuf) -> String?

# 
    # See Zlib::GzipReader documentation for a description.
    #
    def readbyte: () -> Integer

# 
    # See Zlib::GzipReader documentation for a description.
    #
    def readchar: () -> String

# 
    # See Zlib::GzipReader documentation for a description.
    #
    def readline: (?String sep, ?Integer limit) -> String

# 
    # See Zlib::GzipReader documentation for a description.
    #
    def readlines: (?String sep, ?Integer limit) -> ::Array[String]

# 
    # Reads at most *maxlen* bytes from the gzipped stream but it blocks only if
    # *gzipreader* has no data immediately available. If the optional *outbuf*
    # argument is present, it must reference a String, which will receive the data.
    # It raises `EOFError` on end of file.
    #
    def readpartial: (int maxlen, ?string outbuf) -> String

# 
    # Resets the position of the file pointer to the point created the GzipReader
    # object.  The associated IO object needs to respond to the `seek` method.
    #
    def rewind: () -> Integer

# 
    # Total number of output bytes output so far.
    #
    def tell: () -> Integer

# 
    # See Zlib::GzipReader documentation for a description.
    #
    def ungetbyte: (String | Integer arg0) -> NilClass

# 
    # See Zlib::GzipReader documentation for a description.
    #
    def ungetc: (String arg0) -> NilClass

# 
    # Returns the rest of the data which had read for parsing gzip format, or `nil`
    # if the whole gzip file is not parsed yet.
    #
    def unused: () -> String?

private

# 
    # Creates a GzipReader object associated with `io`. The GzipReader object reads
    # gzipped data from `io`, and parses/decompresses it.  The `io` must have a
    # `read` method that behaves same as the IO#read.
    #
    # The `options` hash may be used to set the encoding of the data.
    # `:external_encoding`, `:internal_encoding` and `:encoding` may be set as in
    # IO::new.
    #
    # If the gzip file header is incorrect, raises an Zlib::GzipFile::Error
    # exception.
    #
    def initialize: (_Reader io, **untyped opts) -> void
  end
end

[-] zlib.rbs [edit]
[+] gzip_file
[-] deflate.rbs [edit]
[-] gzip_file.rbs [edit]
[-] mem_error.rbs [edit]
[-] stream_end.rbs [edit]
[-] version_error.rbs [edit]
[-] data_error.rbs [edit]
[-] error.rbs [edit]
[-] stream_error.rbs [edit]
[-] gzip_writer.rbs [edit]
[-] gzip_reader.rbs [edit]
[+] ..
[-] inflate.rbs [edit]
[-] buf_error.rbs [edit]
[-] zstream.rbs [edit]
[-] need_dict.rbs [edit]