class Gem::Package::TarReader::Entry
Klasse zum Lesen von Einträgen aus einer Tar-Datei
Attribute
Header für diesen Tar-Eintrag
Öffentliche Klassenmethoden
Source
# File lib/rubygems/package/tar_reader/entry.rb, line 36 def initialize(header, io) @closed = false @header = header @io = io @orig_pos = @io.pos @end_pos = @orig_pos + @header.size @read = 0 end
Erstellt einen neuen Tar-Eintrag für header, der aus io gelesen wird.
Source
# File lib/rubygems/package/tar_reader/entry.rb, line 18 def self.open(header, io, &block) entry = new header, io return entry unless block_given? begin yield entry ensure entry.close end end
Erstellt einen neuen Tar-Eintrag für header, der aus io gelesen wird. Wenn ein Block übergeben wird, wird der Eintrag übergeben und dann geschlossen.
Öffentliche Instanzmethoden
Source
# File lib/rubygems/package/tar_reader/entry.rb, line 52 def bytes_read @read end
Anzahl der aus dem Tar-Eintrag gelesenen Bytes.
Source
# File lib/rubygems/package/tar_reader/entry.rb, line 59 def close return if closed? # Seek to the end of the entry if it wasn't fully read seek(0, IO::SEEK_END) # discard trailing zeros skip = (512 - (@header.size % 512)) % 512 @io.read(skip) @closed = true nil end
Schließt den Tar-Eintrag.
Source
# File lib/rubygems/package/tar_reader/entry.rb, line 73 def closed? @closed end
Ist der Tar-Eintrag geschlossen?
Source
# File lib/rubygems/package/tar_reader/entry.rb, line 112 def directory? @header.typeflag == "5" end
Ist dieser Tar-Eintrag ein Verzeichnis?
Source
# File lib/rubygems/package/tar_reader/entry.rb, line 80 def eof? check_closed @read >= @header.size end
Sind wir am Ende des Tar-Eintrags?
Source
# File lib/rubygems/package/tar_reader/entry.rb, line 119 def file? @header.typeflag == "0" end
Ist dieser Tar-Eintrag eine Datei?
Source
# File lib/rubygems/package/tar_reader/entry.rb, line 89 def full_name @header.full_name.force_encoding(Encoding::UTF_8) rescue ArgumentError => e raise unless e.message == "string contains null byte" raise Gem::Package::TarInvalidError, "tar is corrupt, name contains null byte" end
Vollständiger Name des Tar-Eintrags.
Source
# File lib/rubygems/package/tar_reader/entry.rb, line 100 def getc return nil if eof? ret = @io.getc @read += 1 if ret ret end
Liest ein Byte aus dem Tar-Eintrag.
Source
# File lib/rubygems/package/tar_reader/entry.rb, line 133 def pos check_closed bytes_read end
Die Position im Tar-Eintrag.
Source
# File lib/rubygems/package/tar_reader/entry.rb, line 142 def pos=(new_pos) seek(new_pos, IO::SEEK_SET) end
Setzt die Position im Tar-Eintrag.
Source
# File lib/rubygems/package/tar_reader/entry.rb, line 155 def read(maxlen = nil) if eof? return maxlen.to_i.zero? ? "" : nil end max_read = [maxlen, @header.size - @read].compact.min ret = @io.read max_read if ret.nil? return maxlen ? nil : "" # IO.read returns nil on EOF with len argument end @read += ret.size ret end
Liest maxlen Bytes aus dem Tar-Datei-Eintrag oder den Rest des Eintrags, wenn nil.
Source
# File lib/rubygems/package/tar_reader/entry.rb, line 171 def readpartial(maxlen, outbuf = "".b) if eof? && maxlen > 0 raise EOFError, "end of file reached" end max_read = [maxlen, @header.size - @read].min @io.readpartial(max_read, outbuf) @read += outbuf.size outbuf end
Source
# File lib/rubygems/package/tar_reader/entry.rb, line 240 def rewind check_closed seek(0, IO::SEEK_SET) end
Setzt den Anfang des Tar-Datei-Eintrags zurück.
Source
# File lib/rubygems/package/tar_reader/entry.rb, line 188 def seek(offset, whence = IO::SEEK_SET) check_closed new_pos = case whence when IO::SEEK_SET then @orig_pos + offset when IO::SEEK_CUR then @io.pos + offset when IO::SEEK_END then @end_pos + offset else raise ArgumentError, "invalid whence" end if new_pos < @orig_pos new_pos = @orig_pos elsif new_pos > @end_pos new_pos = @end_pos end pending = new_pos - @io.pos return 0 if pending == 0 if @io.respond_to?(:seek) begin # avoid reading if the @io supports seeking @io.seek new_pos, IO::SEEK_SET pending = 0 rescue Errno::EINVAL end end # if seeking isn't supported or failed # negative seek requires that we rewind and read if pending < 0 @io.rewind pending = new_pos end while pending > 0 do size_read = @io.read([pending, 4096].min)&.size raise(EOFError, "end of file reached") if size_read.nil? pending -= size_read end @read = @io.pos - @orig_pos 0 end
Setzt die Position um offset Bytes in den Tar-Datei-Eintrag. whence kann IO::SEEK_SET, IO::SEEK_CUR oder IO::SEEK_END sein.
Source
# File lib/rubygems/package/tar_reader/entry.rb, line 146 def size @header.size end
Source
# File lib/rubygems/package/tar_reader/entry.rb, line 126 def symlink? @header.typeflag == "2" end
Ist dieser Tar-Eintrag ein Symlink?