octets-to-native

Function

Package: excl

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 presrved 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.

The documentation is described in introduction.htm and the index is in index.htm.

Copyright (c) 1998-2000, Franz Inc. Berkeley, CA., USA. All rights reserved.

Created 2000.10.5.