On this page:
top
up

16.1Weak BoxesπŸ”— i

A weak box is similar to a normal box (see Boxes), but when the garbage collector (see Garbage Collection) can prove that the content value of a weak box is only reachable via weak references, the content of the weak box is replaced with #f. A weak reference is a reference through a weak box, through a key reference in a weak hash table (see Hash Tables), through a value in an ephemeron where the value can be replaced by #f (see Ephemerons), or through a custodian (see Custodians).

procedure

(make-weak-box v)weak-box?

v:any/c
Returns a new weak box that initially contains v.

procedure

(weak-box-value weak-box[gced-v])any/c

weak-box:weak-box?
gced-v:any/c =#f
Returns the value contained in weak-box. If the garbage collector has proven that the previous content value of weak-box was reachable only through a weak reference, then gced-v (which defaults to #f) is returned.

procedure

(weak-box? v)boolean?

v:any/c
Returns #t if v is a weak box, #f otherwise.

top
up

AltStyle γ«γ‚ˆγ£γ¦ε€‰ζ›γ•γ‚ŒγŸγƒšγƒΌγ‚Έ (->γ‚ͺγƒͺγ‚ΈγƒŠγƒ«) /