allocate-fobject-c

$Revision: 5.0.2.2 $

Macro

Package: FOREIGN-FUNCTIONS

Arguments: (type &optional size)

This function is defined by the ACLWIN compatibility package, loaded with

(require :aclwffi)

However, it is for compatibility with Allegro CL 4.3.2, an early release of the UNIX product on Windows which had limited distribution, not compatibility with Allegro CL 3.0.x on Windows. Calling it does not trigger an autoload of the :aclwffi module so you must use the require form above prior to calls to this function.

This function is provided for porting from Allegro CL 4.3.2 only and users with 4.3.2 code calling this function are urged to covert the call to an allocate-fobject call as quickly as possible. (Use the allocation argument of allocate-fobject to specify where the allocation should occur. Specify :c for allocation to get behavior equivalent to this macro.)

This function allocate an object of the given type in the C heap. If the size argument is given, then it is the minimum size (in bytes) of the data portion of the object that will be allocated. The object will not be moved by the garbage collector. The object will not be automatically reclaimed. To return the space to the C heap, call free-fobject-c. This object is represented in lisp by an integer (which points to the beginning of the object in memory).

See foreign_functions.htm for general information on foreign functions in Allegro CL. See ftype.htm for information on foreign types.

The general documentation description is in introduction.htm. The index is in index.htm.