Function

Summary

Enlarges a generation in 32-bit LispWorks.

Package

hcl

Signature

enlarge-generation gen-num size => result

Arguments

gen-num

A generation number.

size

The amount (in bytes) by which the generation is to be enlarged.

Values

result

A boolean.

Description

The function enlarge-generation enlarges generation gen-num by size bytes. If possible, an existing segment in generation gen-num is enlarged, otherwise a new segment of size size is added to the generation.

result is t on success and nil on failure.

This function is useful when it is known that a generation will need to grow. After enlarge-generation is called, the garbage collector is saved the work of deducing that the generation must grow.

enlarge-generation is most useful in non-interactive applications, where relatively long GC delays are not a problem. In this case, enlarging generations 0 and 1 by several Mb may improve the overall performance of the GC.

Notes

enlarge-generation is implemented only in 32-bit LispWorks. It is not relevant to the Memory Management API in 64-bit implementations. In 64-bit implementations you can use set-default-segment-size.

See also

set-default-segment-size