String#unpack

(::string template, ?offset: ::int) -> ::Array[::Integer | ::Float | ::String | nil]

(::string template, ?offset: ::int) { (::Integer | ::Float | ::String | nil value) -> void } -> nil

unpack(template, offset: 0, &block) → array

# File tmp/rubies/ruby-3.4.1/pack.rb, line 23
def unpack(fmt, offset: 0)
  Primitive.attr! :use_block
  Primitive.pack_unpack(fmt, offset)
end

Extracts data from self.

If block is not given, forming objects that become the elements of a new array, and returns that array. Otherwise, yields each object.

Ruby version changes

3.3
- String#unpack now raises ArgumentError for unknown directives. [Bug #19150]
3.1
- String#unpack and String#unpack1 now accept an offset: keyword argument to start the unpacking after an arbitrary number of bytes have been skipped. If offset is outside of the string bounds ArgumentError is raised. [Feature #18254]

See also #unicode_normalized? #unpack1 #unicode_normalize! #upcase also in 4.1 · 4.0 · 3.3 · 3.2 · 3.1 · 3.0