Function

Summary

Controls when objects can be promoted to the next generation in 32-bit LispWorks. This function is deprecated.

Package

hcl

Signature

set-promotion-count gen-num count &optional segment => count

Arguments

gen-num

The generation number affected.

count

The number of garbage collections survived by objects in that generation, before promotion. If count is nil, the function returns the current promotion count setting.

segment

An integer specifying which segment of the generation is to be affected. The default is 0, meaning the lowest segment of the generation.

Values

Returns count.

Description

Controls how many garbage collections an object in a segment must survive before promotion to the next generation.

Notes

1. set-promotion-count is deprecated, because experience has shown that it is not useful.
2. set-promotion-count is implemented only in 32-bit LispWorks. It is not relevant to the Memory Management API in 64-bit implementations, wherein you may be able to achieve the effect with set-delay-promotion.

See also

block-promotion
clean-generation-0
collect-generation-2
collect-highest-generation
expand-generation-1