Home /Modules/api/GC-HINT-API.md

GC-HINT-API.md

api/sleela/2.1/runtime/gc/GC-HINT-API.md · 31 line(s) · markdown

Syntax 1.9 GC-Hint API

Forms

The syntax 1.9 regression fixtures document these assignment forms:

target = gc 80;
target = mem 25;
target = gc;

The forms are contextual: gc and mem remain ordinary identifiers outside the whole right-hand side of a recognized hint assignment. The bare gc form is documented by the fixtures as a default-aggressiveness request.

Contract

Implementation boundaries

This is the language-level hint contract. It is not the same interface as gc_collect_young / gc_collect_full in the native collector, nor the native memory manager's tracked allocation API. The runtime decides how to honor a valid hint safely.

Regression evidence

See test matrix and the canonical syntax 1.9 fixture README.