JS_RemoveRootRT 编辑

Obsolete
This feature is obsolete. Although it may still work in some browsers, its use is discouraged since it could be removed at any time. Try to avoid using it.

Unregisters a pointer to a GC thing so that it is no longer a member of the garbage collector's root set. This enables any pointed-at GC thing to be garbage collected as needed.

Syntax

JSBool JS_RemoveRootRT(JSRuntime *rt, void *rp);

Description

JS_RemoveRootRT removes the GC thing that rp points to from the list of GC things that are protected from garbage collection. rp is thus a pointer to a pointer to a JS double, String, or Object. Do not pass a pointer to a JS double, string, or object -- you must pass a pointer to a pointer or a pointer to a jsval that's a GC thing. The entry for the GC thing rp points to is removed in the garbage collection hash table for the specified runtime, rt.

JS_RemoveRootRT always returns JS_TRUE.

See Also

MXR ID Search for JS_RemoveRoot

• JSVAL_IS_GCTHING
• JS_AddRoot
• JS_AddNamedRoot
• JS_AddNamedRootRT
• JS_DumpNamedRoots,
• JS_RemoveRoot