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