File: //usr/share/ri/3.0.0/system/String/unpack1-i.ri
U:RDoc::AnyMethod[iI"unpack1:ETI"String#unpack1;TF:publico:RDoc::Markup::Document:@parts[o:RDoc::Markup::Paragraph; [I"IDecodes <i>str</i> (which may contain binary data) according to the ;TI"9format string, returning the first value extracted. ;TI"(See also String#unpack, Array#pack.;To:RDoc::Markup::BlankLine o;
; [I"!Contrast with String#unpack:;T@o:RDoc::Markup::Verbatim; [I"="abc \0\0abc \0\0".unpack('A6Z6') #=> ["abc", "abc "]
;TI"3"abc \0\0abc \0\0".unpack1('A6Z6') #=> "abc"
;T:@format0o;
; [I"LIn that case data would be lost but often it's the case that the array ;TI"Oonly holds one value, especially when unpacking binary data. For instance:;T@o;
; [I"7"\xff\x00\x00\x00".unpack("l") #=> [255] ;TI"4"\xff\x00\x00\x00".unpack1("l") #=> 255;T@o;
; [I"GThus unpack1 is convenient, makes clear the intention and signals ;TI"9the expected return value to those reading the code.;T:
@fileI"pack.rb;T:0@omit_headings_from_table_of_contents_below0I"$str.unpack1(format) -> obj
;T0[ I"
(fmt);T@$FI"String;TcRDoc::NormalClass00