class Tar::Minitar::Reader::EntryStream
EntryStreams are pseudo-streams on top of the main data stream.
Public Class Methods
new(header, io)
click to toggle source
# File lib/archive/tar/minitar/reader.rb, line 32 def initialize(header, io) @io = io @name = header.name @mode = header.mode @uid = header.uid @gid = header.gid @size = header.size @mtime = header.mtime @checksum = header.checksum @typeflag = header.typeflag @linkname = header.linkname @magic = header.magic @version = header.version @uname = header.uname @gname = header.gname @devmajor = header.devmajor @devminor = header.devminor @prefix = header.prefix @read = 0 @orig_pos = if Archive::Tar::Minitar.seekable?(@io) @io.pos else 0 end end
Public Instance Methods
bytes_read()
click to toggle source
# File lib/archive/tar/minitar/reader.rb, line 122 def bytes_read @read end
close()
click to toggle source
Closes the entry.
# File lib/archive/tar/minitar/reader.rb, line 141 def close invalidate end
closed?()
click to toggle source
Returns false if the entry stream is valid.
# File lib/archive/tar/minitar/reader.rb, line 136 def closed? false end
directory?()
click to toggle source
Returns true
if the entry represents a directory.
# File lib/archive/tar/minitar/reader.rb, line 80 def directory? case @typeflag when '5' true when '0', "\0" # If the name ends with a slash, treat it as a directory. # This is what other major tar implementations do for # interoperability and compatibility with older tar variants # and some new ones. @name.end_with?('/') else false end end
Also aliased as: directory
eof?()
click to toggle source
Returns true
if the current read pointer is at the end of the EntryStream
data.
# File lib/archive/tar/minitar/reader.rb, line 104 def eof? @read >= @size end
file?()
click to toggle source
Returns true
if the entry represents a plain file.
# File lib/archive/tar/minitar/reader.rb, line 97 def file? (@typeflag == '0' || @typeflag == "\0") && !@name.end_with?('/') end
Also aliased as: file
full_name()
click to toggle source
Returns the full and proper name of the entry.
# File lib/archive/tar/minitar/reader.rb, line 127 def full_name if @prefix != '' File.join(@prefix, @name) else @name end end
getc()
click to toggle source
Reads one byte from the entry. Returns nil
if there is no more data to read.
# File lib/archive/tar/minitar/reader.rb, line 72 def getc return nil if @read >= @size ret = @io.getc @read += 1 if ret ret end
pos()
click to toggle source
Returns the current read pointer in the EntryStream
.
# File lib/archive/tar/minitar/reader.rb, line 109 def pos @read end
read(len = nil)
click to toggle source
Reads len
bytes (or all remaining data) from the entry. Returns nil
if there is no more data to read.
# File lib/archive/tar/minitar/reader.rb, line 61 def read(len = nil) return nil if @read >= @size len ||= @size - @read max_read = [len, @size - @read].min ret = @io.read(max_read) @read += bytesize(ret) ret end
rewind()
click to toggle source
Sets the current read pointer to the beginning of the EntryStream
.
# File lib/archive/tar/minitar/reader.rb, line 114 def rewind unless Archive::Tar::Minitar.seekable?(@io, :pos=) raise Archive::Tar::Minitar::NonSeekableStream end @io.pos = @orig_pos @read = 0 end
Private Instance Methods
invalidate()
click to toggle source
# File lib/archive/tar/minitar/reader.rb, line 147 def invalidate extend InvalidEntryStream end