cast-array ( byte-array c-type -- array )

Vocabulary
alien.data

Inputs

byte-array	a byte-array
c-type	a C type

Outputs

array

a specialized array

Word description
Converts a byte-array into a specialized array by interpreting the bytes in it as machine-specific values. Code using this word is unportable.

Notes
The appropriate specialized array vocabulary must be loaded, otherwise an error will be thrown. See the specialized-arrays vocabulary for details on the underlying sequence type constructed.

Errors
Throws an error if the type does not exist, the necessary specialized array vocabulary is not loaded, or the requested size is negative.

Definition

USING: alien alien.c-types kernel math ;

IN: alien.data

: cast-array ( byte-array c-type -- array )
[ binary-object ] dip [ heap-size /mod 0 = ] keep swap
[ <c-direct-array> ] [ bad-byte-array-length ] if ; inline