Function

Summary

Applies a function to all the live objects in the image.

Package

hcl

Signature

sweep-all-objects function &optional gen-0 => nil

Arguments

function

A function of one argument, the object.

gen-0

A generalized boolean, default value nil

Values

sweep-all-objects returns nil.

Description

Applies function to all the live objects in the image. Normally it is not useful to sweep objects in generation 0 because they are ephemeral, so by default sweep-all-objects does not sweep generation 0. This can be changed by passing a non-nil value as gen-0.

function should take one argument, the object. It can allocate, but if it allocates heavily the sweeping becomes unreliable. Small amounts of allocation will normally happen only in generation 0, and so will not affect sweeping of other generations.

To call sweep-all-objects reliably, do it inside with-other-threads-disabled.

Notes

In 64-bit LispWorks there is a more specific alternative: function sweep-gen-num-objects can be used to call a function on all live objects in a particular generation.

See also

sweep-gen-num-objects