octets-to-native

Arguments: vector8 &key address (length (position 0 vector8))

This function returns an address.

This function copies the 8-bit bytes from vector8, a (simple-array (unsigned-byte 8) (*)) array, into static (i.e., non-lisp heap) memory and returns an address to the first character of that data.

If the address argument is specified, then its value will be used (and returned) as the destination address and new memory will not be allocated. If the address argument is not specified, then the resulting memory must be passed to aclfree to be reclaimed.

If the length argument is specified, then it specifies the number of elements to copy.

In earlier releases, this function was called mb-to-native. That name is preserved for backward compatibility, but new code should use the new name.

See also iacl.htm for general information on international character set support in Allegro CL and see native-to-octets.

Copyright (c) 1998-2002, Franz Inc. Oakland, CA., USA. All rights reserved.
Documentation for Allegro CL version 6.2. This page was not revised from the 6.1 page.
Created 2002.2.26.