free-foreign-block Function

Summary

Frees a foreign block that was allocated by Lisp, in LispWorks for Macintosh.

Package

fli

Signature

free-foreign-block foreign-block

Arguments

foreign-block⇩

A Lisp-allocated foreign-block-pointer.

Description

The function free-foreign-block frees a foreign block that was allocated by Lisp.

foreign-block must be a result of a call to allocate-foreign-block. It is an error to call free-foreign-block on the result of foreign-block-copy or on a foreign block coming from foreign code.

Note that the function that was passed to allocate-foreign-block may still be invoked after free-foreign-block, because the block may have been copied. See the discussion in 5.7.3 Scope of invocation.

It is an error to call free-foreign-block more than once on the same foreign-block.

free-foreign-block has no useful return value.

Notes

1. To free a foreign block that was allocated by foreign code, use foreign-block-release.
2. free-foreign-block is implemented in LispWorks for Macintosh only.

See also

allocate-foreign-block
with-foreign-block
5.7 Block objects in C (foreign blocks)