unpack

Synthesised documentation from type/Blob

From type/Blob

This method is considered experimental, in order to use it you will need to do:

use experimental :pack;
 
multi method unpack(Blob:D: Str:D $template)
multi method unpack(Blob:D: @template)
multi sub unpack(Blob:D \blob, Str:D $template)
multi sub unpack(Blob:D \blob, @template)

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)␤»