mozilla
Your Search Results

    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);
    
    Name Type Description
    rt JSruntime * Pointer to the runtime with which the root was registered.
    rp void * Address of the pointer to no longer protect. This must have been passed to one of JS_AddRoot, JS_AddNamedRoot, or JS_AddNamedRootRT earlier.

    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

    Document Tags and Contributors

    Contributors to this page: fscholz, Nickolay, Jorend, Michelemostarda
    Last updated by: fscholz,
    Hide Sidebar