In role Blob§
See primary documentation in context for routine unpack
This method is considered experimental, in order to use it you will need to do:
use experimental :pack;multi method unpack(Blob: Str )multi method unpack(Blob: )multi unpack(Blob \blob, Str )multi unpack(Blob \blob, )
Extracts features from the blob according to the template string, and returns them as a list.
The template string consists of zero or more units that begin with an ASCII letter, and are optionally followed by a quantifier. The quantifier can be *
(which typically stands for "use up the rest of the Blob here"), or a positive integer (without a +
).
Whitespace between template units is ignored.
Examples of valid templates include "A4 C n*"
and "A*"
.
The following letters are recognized:
Letter | Meaning |
---|---|
A | Extract a string, where each element of the Blob maps to a codepoint |
a | Same as 'A' |
C | Extract an element from the blob as an integer |
H | Extracts a hex string |
L | Extracts four elements and returns them as a single unsigned integer |
n | Extracts two elements and combines them in "network" (BigEndian) byte order into a single integer |
N | Extracts four elements and combines them in "network" (BigEndian) byte order into a single integer |
S | Extracts two elements and returns them as a single unsigned integer |
v | Same as 'S' |
V | Same as 'L' |
x | Drop an element from the blob (that is, ignore it) |
Z | Same as 'A' |
Example:
use experimental :pack;say Blob.new(1..10).unpack("C*");# OUTPUT: «(1 2 3 4 5 6 7 8 9 10)»