Description:

Whenever a value of a struct or union type is returned by a method call or given as an argument to a method implemented in Lisp, it is encapsulated in a foreign-value that by default deallocates the value upon its finalisation by the garbage collector.

You can extract a system area pointer that points directly to the wrapped foreign data by calling foreign-value-pointer.

You can control finalisation behaviour by using the foreign-value-lisp-managed-p accessor.

See also:

foreign-value-pointer, foreign-value-lisp-managed-p, foreign-struct, foreign-union