clean-generation-0 Function

Summary

Attempts to promote all objects from generation 0 into generation 1, in 32-bit LispWorks.

Package

hcl

Signature

clean-generation-0

Description

The function clean-generation-0 attempts to promote all objects from generation 0 into generation 1, thereby clearing generation zero, in 32-bit LispWorks.

This is useful when passing from a phase of creating long-lived data to a phase of mostly ephemeral data, for example, the end of loading an application and the start of its use.

Notes

1. The function may not be very useful, as it may be more efficient to directly allocate the objects in a particular generation in the first place, using allocation-in-gen-num or set-default-generation.
2. clean-generation-0 is implemented only in 32-bit LispWorks. It is not relevant to the Memory Management API in 64-bit implementations, where the same effect can be obtained by a call (gc-generation 0).

Examples

;   allocate lots of non-ephemeral objects 
;   ......  
(clean-generation-0)

See also

allocation-in-gen-num
collect-generation-2
collect-highest-generation
expand-generation-1
gc-generation
set-promotion-count
11.3 Memory Management in 32-bit LispWorks