mozilla
Your Search Results

    JSPRINCIPALS_HOLD

    Obsolete since JSAPI 13
    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.

    Increment or decrement the reference count of a JSPrincipals object.

    Syntax

    JSPRINCIPALS_HOLD(cx, principals)
    
    JSPRINCIPALS_DROP(cx, principals)
    
    Name Type Description
    cx JSContext * A context.
    principals JSPrincipals * Pointer to the JSPrincipals object to hold or drop. This argument must not be NULL.

    Description

    JSPRINCIPALS_HOLD and JSPRINCIPALS_DROP are used to manage memory for JSPrincipals objects.

    Principals are used by the SpiderMonkey security system. JSPrincipals objects are not JSObjects. They are reference counted, not garbage collected. Application code that stores a pointer to a JSPrincipals object must call JSPRINCIPALS_HOLD(cx, principals) before storing it and JSPRINCIPALS_DROP(cx, principals) when done with it.

    JSPRINCIPALS_HOLD(cx, principals) increments the reference count of principals by 1.

    JSPRINCIPALS_DROP(cx, principals) decrements the reference count of principals by 1. If the reference count drops to 0, indicating that no one is using the object anymore, JSPRINCIPALS_DROP also deallocates principals by calling its destroy method.

    See Also

    Document Tags and Contributors

    Contributors to this page: fscholz, arai, MMondor, tschneidereit, Dria, Jorend
    Last updated by: arai,
    Hide Sidebar