Class: Zip::ExtraField
- Inherits:
-
Hash
- Object
- Hash
- Zip::ExtraField
show all
- Defined in:
- lib/zip/extra_field.rb
Overview
Defined Under Namespace
Classes: Generic, IUnix, NTFS, OldUnix, UniversalTime, Unknown, Zip64
Constant Summary
collapse
- ID_MAP =
{}
Instance Method Summary
collapse
-
#c_dir_size ⇒ Object
-
#create(name) ⇒ Object
-
#extra_field_type_exist(binstr, id, len, index) ⇒ Object
-
#extra_field_type_unknown(binstr, len, index, local) ⇒ Object
-
#initialize(binstr = nil, local: false) ⇒ ExtraField
constructor
A new instance of ExtraField.
-
#local_size ⇒ Object
(also: #length, #size)
-
#merge(binstr, local: false) ⇒ Object
-
#ordered_values ⇒ Object
Place Unknown last, so “extra” data that is missing the proper signature/size does not prevent known fields from being read back in.
-
#to_c_dir_bin ⇒ Object
-
#to_local_bin ⇒ Object
(also: #to_s)
Constructor Details
#initialize(binstr = nil, local: false) ⇒ ExtraField
Returns a new instance of ExtraField.
7
8
9
|
# File 'lib/zip/extra_field.rb', line 7
def initialize(binstr = nil, local: false)
merge(binstr, local: local) if binstr
end
|
Instance Method Details
#c_dir_size ⇒ Object
74
75
76
|
# File 'lib/zip/extra_field.rb', line 74
def c_dir_size
to_c_dir_bin.bytesize
end
|
#create(name) ⇒ Object
48
49
50
51
52
53
54
|
# File 'lib/zip/extra_field.rb', line 48
def create(name)
unless (field_class = ID_MAP.values.find { |k| k.name == name })
raise Error, "Unknown extra field '#{name}'"
end
self[name] = field_class.new
end
|
11
12
13
14
15
16
17
18
19
|
# File 'lib/zip/extra_field.rb', line 11
def (binstr, id, len, index)
field_name = ID_MAP[id].name
if member?(field_name)
self[field_name].merge(binstr[index, len + 4])
else
field_obj = ID_MAP[id].new(binstr[index, len + 4])
self[field_name] = field_obj
end
end
|
21
22
23
24
25
26
27
28
29
30
|
# File 'lib/zip/extra_field.rb', line 21
def (binstr, len, index, local)
self['Unknown'] ||= Unknown.new
if !len || len + 4 > binstr[index..-1].bytesize
self['Unknown'].merge(binstr[index..-1], local: local)
return
end
self['Unknown'].merge(binstr[index, len + 4], local: local)
end
|
#local_size ⇒ Object
Also known as:
length, size
78
79
80
|
# File 'lib/zip/extra_field.rb', line 78
def local_size
to_local_bin.bytesize
end
|
#merge(binstr, local: false) ⇒ Object
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
|
# File 'lib/zip/extra_field.rb', line 32
def merge(binstr, local: false)
return if binstr.empty?
i = 0
while i < binstr.bytesize
id = binstr[i, 2]
len = binstr[i + 2, 2].to_s.unpack1('v')
if id && ID_MAP.member?(id)
(binstr, id, len, i)
elsif id
break unless (binstr, len, i, local)
end
i += len + 4
end
end
|
#ordered_values ⇒ Object
Place Unknown last, so “extra” data that is missing the proper signature/size does not prevent known fields from being read back in.
58
59
60
61
62
|
# File 'lib/zip/extra_field.rb', line 58
def ordered_values
result = []
each { |k, v| k == 'Unknown' ? result.push(v) : result.unshift(v) }
result
end
|
#to_c_dir_bin ⇒ Object
70
71
72
|
# File 'lib/zip/extra_field.rb', line 70
def to_c_dir_bin
ordered_values.map! { |v| v.to_c_dir_bin.force_encoding('BINARY') }.join
end
|
#to_local_bin ⇒ Object
Also known as:
to_s
64
65
66
|
# File 'lib/zip/extra_field.rb', line 64
def to_local_bin
ordered_values.map! { |v| v.to_local_bin.force_encoding('BINARY') }.join
end
|