schedule-finalization

$Revision: 5.0.2.2 $

Function

Package: EXCL

Arguments: (object function)

Returns a finalization for object. When the garbage collector identifies object as garbage (meaning only the finalization and possibly weak vectors reference it), the garbage collector notes this fact and when it finishes garbage collecting, it calls the function denoted by function with object as the single argument. After that function returns, the finalization is disabled so that (assuming that nothing in function caused object not to be garbage) the object is again identified as garbage during the next garbage collection and then scavenged (or global gc'ed) away. object can be any Lisp object; function can be a function object or a symbol denoting a function. The function must accept one argument.

See gc.htm for a discussion of finalizations.

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