instance method

String#unpack1

(::string template, ?offset: ::int) -> (::Integer | ::Float | ::String)?

unpack1(template, offset: 0) → object

# File tmp/rubies/ruby-4.0.0/pack.rb, line 37
def unpack1(fmt, offset: 0)
  Primitive.pack_unpack1(fmt, offset)
end

Like String#unpack with no block, but unpacks and returns only the first extracted object. See Packed Data.

Ruby version changes

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 #unpack #upcase #unicode_normalized? #upcase! also in 4.1 · 3.4 · 3.3 · 3.2 · 3.1 · 3.0