NextPrevUpTopContentsIndex

enlarge-generation

Function
Summary

Enlarges a generation.

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.


LispWorks Reference Manual - 23 Jul 2004

NextPrevUpTopContentsIndex