Annotation of sbbs/include/mozilla/js/jsobj.h, revision 1.1.1.2

1.1       root        1: /* -*- Mode: C; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 4 -*-
1.1.1.2 ! root        2:  * vim: set ts=8 sw=4 et tw=80:
1.1       root        3:  *
                      4:  * ***** BEGIN LICENSE BLOCK *****
                      5:  * Version: MPL 1.1/GPL 2.0/LGPL 2.1
                      6:  *
                      7:  * The contents of this file are subject to the Mozilla Public License Version
                      8:  * 1.1 (the "License"); you may not use this file except in compliance with
                      9:  * the License. You may obtain a copy of the License at
                     10:  * http://www.mozilla.org/MPL/
                     11:  *
                     12:  * Software distributed under the License is distributed on an "AS IS" basis,
                     13:  * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
                     14:  * for the specific language governing rights and limitations under the
                     15:  * License.
                     16:  *
                     17:  * The Original Code is Mozilla Communicator client code, released
                     18:  * March 31, 1998.
                     19:  *
                     20:  * The Initial Developer of the Original Code is
                     21:  * Netscape Communications Corporation.
                     22:  * Portions created by the Initial Developer are Copyright (C) 1998
                     23:  * the Initial Developer. All Rights Reserved.
                     24:  *
                     25:  * Contributor(s):
                     26:  *
                     27:  * Alternatively, the contents of this file may be used under the terms of
                     28:  * either of the GNU General Public License Version 2 or later (the "GPL"),
                     29:  * or the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
                     30:  * in which case the provisions of the GPL or the LGPL are applicable instead
                     31:  * of those above. If you wish to allow use of your version of this file only
                     32:  * under the terms of either the GPL or the LGPL, and not to allow others to
                     33:  * use your version of this file under the terms of the MPL, indicate your
                     34:  * decision by deleting the provisions above and replace them with the notice
                     35:  * and other provisions required by the GPL or the LGPL. If you do not delete
                     36:  * the provisions above, a recipient may use your version of this file under
                     37:  * the terms of any one of the MPL, the GPL or the LGPL.
                     38:  *
                     39:  * ***** END LICENSE BLOCK ***** */
                     40: 
                     41: #ifndef jsobj_h___
                     42: #define jsobj_h___
                     43: /*
                     44:  * JS object definitions.
                     45:  *
                     46:  * A JS object consists of a possibly-shared object descriptor containing
                     47:  * ordered property names, called the map; and a dense vector of property
                     48:  * values, called slots.  The map/slot pointer pair is GC'ed, while the map
                     49:  * is reference counted and the slot vector is malloc'ed.
                     50:  */
                     51: #include "jshash.h" /* Added by JSIFY */
                     52: #include "jsprvtd.h"
                     53: #include "jspubtd.h"
                     54: 
                     55: JS_BEGIN_EXTERN_C
                     56: 
                     57: struct JSObjectMap {
                     58:     jsrefcount  nrefs;          /* count of all referencing objects */
                     59:     JSObjectOps *ops;           /* high level object operation vtable */
                     60:     uint32      nslots;         /* length of obj->slots vector */
                     61:     uint32      freeslot;       /* index of next free obj->slots element */
                     62: };
                     63: 
                     64: /* Shorthand macros for frequently-made calls. */
                     65: #define OBJ_LOOKUP_PROPERTY(cx,obj,id,objp,propp)                             \
                     66:     (obj)->map->ops->lookupProperty(cx,obj,id,objp,propp)
                     67: #define OBJ_DEFINE_PROPERTY(cx,obj,id,value,getter,setter,attrs,propp)        \
                     68:     (obj)->map->ops->defineProperty(cx,obj,id,value,getter,setter,attrs,propp)
                     69: #define OBJ_GET_PROPERTY(cx,obj,id,vp)                                        \
                     70:     (obj)->map->ops->getProperty(cx,obj,id,vp)
                     71: #define OBJ_SET_PROPERTY(cx,obj,id,vp)                                        \
                     72:     (obj)->map->ops->setProperty(cx,obj,id,vp)
                     73: #define OBJ_GET_ATTRIBUTES(cx,obj,id,prop,attrsp)                             \
                     74:     (obj)->map->ops->getAttributes(cx,obj,id,prop,attrsp)
                     75: #define OBJ_SET_ATTRIBUTES(cx,obj,id,prop,attrsp)                             \
                     76:     (obj)->map->ops->setAttributes(cx,obj,id,prop,attrsp)
                     77: #define OBJ_DELETE_PROPERTY(cx,obj,id,rval)                                   \
                     78:     (obj)->map->ops->deleteProperty(cx,obj,id,rval)
                     79: #define OBJ_DEFAULT_VALUE(cx,obj,hint,vp)                                     \
                     80:     (obj)->map->ops->defaultValue(cx,obj,hint,vp)
                     81: #define OBJ_ENUMERATE(cx,obj,enum_op,statep,idp)                              \
                     82:     (obj)->map->ops->enumerate(cx,obj,enum_op,statep,idp)
                     83: #define OBJ_CHECK_ACCESS(cx,obj,id,mode,vp,attrsp)                            \
                     84:     (obj)->map->ops->checkAccess(cx,obj,id,mode,vp,attrsp)
                     85: 
                     86: /* These four are time-optimized to avoid stub calls. */
                     87: #define OBJ_THIS_OBJECT(cx,obj)                                               \
                     88:     ((obj)->map->ops->thisObject                                              \
                     89:      ? (obj)->map->ops->thisObject(cx,obj)                                    \
                     90:      : (obj))
                     91: #define OBJ_DROP_PROPERTY(cx,obj,prop)                                        \
                     92:     ((obj)->map->ops->dropProperty                                            \
                     93:      ? (obj)->map->ops->dropProperty(cx,obj,prop)                             \
                     94:      : (void)0)
                     95: #define OBJ_GET_REQUIRED_SLOT(cx,obj,slot)                                    \
                     96:     ((obj)->map->ops->getRequiredSlot                                         \
                     97:      ? (obj)->map->ops->getRequiredSlot(cx, obj, slot)                        \
                     98:      : JSVAL_VOID)
                     99: #define OBJ_SET_REQUIRED_SLOT(cx,obj,slot,v)                                  \
                    100:     ((obj)->map->ops->setRequiredSlot                                         \
                    101:      ? (obj)->map->ops->setRequiredSlot(cx, obj, slot, v)                     \
                    102:      : JS_TRUE)
                    103: 
1.1.1.2 ! root      104: #define OBJ_TO_INNER_OBJECT(cx,obj)                                           \
        !           105:     JS_BEGIN_MACRO                                                            \
        !           106:         JSClass *clasp_ = OBJ_GET_CLASS(cx, obj);                             \
        !           107:         if (clasp_->flags & JSCLASS_IS_EXTENDED) {                            \
        !           108:             JSExtendedClass *xclasp_ = (JSExtendedClass*)clasp_;              \
        !           109:             if (xclasp_->innerObject)                                         \
        !           110:                 obj = xclasp_->innerObject(cx, obj);                          \
        !           111:         }                                                                     \
        !           112:     JS_END_MACRO
        !           113: 
1.1       root      114: /*
                    115:  * In the original JS engine design, obj->slots pointed to a vector of length
                    116:  * JS_INITIAL_NSLOTS words if obj->map was shared with a prototype object,
                    117:  * else of length obj->map->nslots.  With the advent of JS_GetReservedSlot,
                    118:  * JS_SetReservedSlot, and JSCLASS_HAS_RESERVED_SLOTS (see jsapi.h), the size
                    119:  * of the minimum length slots vector in the case where map is shared cannot
                    120:  * be constant.  This length starts at JS_INITIAL_NSLOTS, but may advance to
                    121:  * include all the reserved slots.
                    122:  *
                    123:  * Therefore slots must be self-describing.  Rather than tag its low order bit
                    124:  * (a bit is all we need) to distinguish initial length from reserved length,
                    125:  * we do "the BSTR thing": over-allocate slots by one jsval, and store the
                    126:  * *net* length (counting usable slots, which have non-negative obj->slots[]
                    127:  * indices) in obj->slots[-1].  All code that sets obj->slots must be aware of
                    128:  * this hack -- you have been warned, and jsobj.c has been updated!
                    129:  */
                    130: struct JSObject {
                    131:     JSObjectMap *map;
                    132:     jsval       *slots;
                    133: };
                    134: 
                    135: #define JSSLOT_PROTO        0
                    136: #define JSSLOT_PARENT       1
                    137: #define JSSLOT_CLASS        2
                    138: #define JSSLOT_PRIVATE      3
                    139: #define JSSLOT_START(clasp) (((clasp)->flags & JSCLASS_HAS_PRIVATE)           \
                    140:                              ? JSSLOT_PRIVATE + 1                             \
                    141:                              : JSSLOT_CLASS + 1)
                    142: 
                    143: #define JSSLOT_FREE(clasp)  (JSSLOT_START(clasp)                              \
                    144:                              + JSCLASS_RESERVED_SLOTS(clasp))
                    145: 
                    146: #define JS_INITIAL_NSLOTS   5
                    147: 
                    148: #ifdef DEBUG
                    149: #define MAP_CHECK_SLOT(map,slot) \
                    150:     JS_ASSERT((uint32)slot < JS_MIN((map)->freeslot, (map)->nslots))
                    151: #define OBJ_CHECK_SLOT(obj,slot) \
                    152:     MAP_CHECK_SLOT((obj)->map, slot)
                    153: #else
                    154: #define OBJ_CHECK_SLOT(obj,slot) ((void)0)
                    155: #endif
                    156: 
                    157: /* Fast macros for accessing obj->slots while obj is locked (if thread-safe). */
                    158: #define LOCKED_OBJ_GET_SLOT(obj,slot) \
                    159:     (OBJ_CHECK_SLOT(obj, slot), (obj)->slots[slot])
                    160: #define LOCKED_OBJ_SET_SLOT(obj,slot,value) \
                    161:     (OBJ_CHECK_SLOT(obj, slot), (obj)->slots[slot] = (value))
                    162: #define LOCKED_OBJ_GET_PROTO(obj) \
                    163:     JSVAL_TO_OBJECT(LOCKED_OBJ_GET_SLOT(obj, JSSLOT_PROTO))
                    164: #define LOCKED_OBJ_GET_CLASS(obj) \
                    165:     ((JSClass *)JSVAL_TO_PRIVATE(LOCKED_OBJ_GET_SLOT(obj, JSSLOT_CLASS)))
                    166: 
                    167: #ifdef JS_THREADSAFE
                    168: 
                    169: /* Thread-safe functions and wrapper macros for accessing obj->slots. */
                    170: #define OBJ_GET_SLOT(cx,obj,slot)                                             \
                    171:     (OBJ_CHECK_SLOT(obj, slot),                                               \
                    172:      (OBJ_IS_NATIVE(obj) && OBJ_SCOPE(obj)->ownercx == cx)                    \
                    173:      ? LOCKED_OBJ_GET_SLOT(obj, slot)                                         \
                    174:      : js_GetSlotThreadSafe(cx, obj, slot))
                    175: 
                    176: #define OBJ_SET_SLOT(cx,obj,slot,value)                                       \
                    177:     (OBJ_CHECK_SLOT(obj, slot),                                               \
                    178:      (OBJ_IS_NATIVE(obj) && OBJ_SCOPE(obj)->ownercx == cx)                    \
                    179:      ? (void) LOCKED_OBJ_SET_SLOT(obj, slot, value)                           \
                    180:      : js_SetSlotThreadSafe(cx, obj, slot, value))
                    181: 
                    182: /*
                    183:  * If thread-safe, define an OBJ_GET_SLOT wrapper that bypasses, for a native
                    184:  * object, the lock-free "fast path" test of (OBJ_SCOPE(obj)->ownercx == cx),
                    185:  * to avoid needlessly switching from lock-free to lock-full scope when doing
                    186:  * GC on a different context from the last one to own the scope.  The caller
                    187:  * in this case is probably a JSClass.mark function, e.g., fun_mark, or maybe
                    188:  * a finalizer.
                    189:  *
                    190:  * The GC runs only when all threads except the one on which the GC is active
                    191:  * are suspended at GC-safe points, so there is no hazard in directly accessing
                    192:  * obj->slots[slot] from the GC's thread, once rt->gcRunning has been set.  See
                    193:  * jsgc.c for details.
                    194:  */
                    195: #define THREAD_IS_RUNNING_GC(rt, thread)                                      \
                    196:     ((rt)->gcRunning && (rt)->gcThread == (thread))
                    197: 
                    198: #define CX_THREAD_IS_RUNNING_GC(cx)                                           \
                    199:     THREAD_IS_RUNNING_GC((cx)->runtime, (cx)->thread)
                    200: 
                    201: #define GC_AWARE_GET_SLOT(cx, obj, slot)                                      \
                    202:     ((OBJ_IS_NATIVE(obj) && CX_THREAD_IS_RUNNING_GC(cx))                      \
                    203:      ? (obj)->slots[slot]                                                     \
                    204:      : OBJ_GET_SLOT(cx, obj, slot))
                    205: 
                    206: #else   /* !JS_THREADSAFE */
                    207: 
                    208: #define OBJ_GET_SLOT(cx,obj,slot)       LOCKED_OBJ_GET_SLOT(obj,slot)
                    209: #define OBJ_SET_SLOT(cx,obj,slot,value) LOCKED_OBJ_SET_SLOT(obj,slot,value)
                    210: #define GC_AWARE_GET_SLOT(cx,obj,slot)  LOCKED_OBJ_GET_SLOT(obj,slot)
                    211: 
                    212: #endif /* !JS_THREADSAFE */
                    213: 
                    214: /* Thread-safe proto, parent, and class access macros. */
                    215: #define OBJ_GET_PROTO(cx,obj) \
                    216:     JSVAL_TO_OBJECT(OBJ_GET_SLOT(cx, obj, JSSLOT_PROTO))
                    217: #define OBJ_SET_PROTO(cx,obj,proto) \
                    218:     OBJ_SET_SLOT(cx, obj, JSSLOT_PROTO, OBJECT_TO_JSVAL(proto))
                    219: 
                    220: #define OBJ_GET_PARENT(cx,obj) \
                    221:     JSVAL_TO_OBJECT(OBJ_GET_SLOT(cx, obj, JSSLOT_PARENT))
                    222: #define OBJ_SET_PARENT(cx,obj,parent) \
                    223:     OBJ_SET_SLOT(cx, obj, JSSLOT_PARENT, OBJECT_TO_JSVAL(parent))
                    224: 
                    225: #define OBJ_GET_CLASS(cx,obj) \
                    226:     ((JSClass *)JSVAL_TO_PRIVATE(OBJ_GET_SLOT(cx, obj, JSSLOT_CLASS)))
                    227: 
                    228: /* Test whether a map or object is native. */
                    229: #define MAP_IS_NATIVE(map)                                                    \
                    230:     ((map)->ops == &js_ObjectOps ||                                           \
                    231:      ((map)->ops && (map)->ops->newObjectMap == js_ObjectOps.newObjectMap))
                    232: 
                    233: #define OBJ_IS_NATIVE(obj)  MAP_IS_NATIVE((obj)->map)
                    234: 
                    235: extern JS_FRIEND_DATA(JSObjectOps) js_ObjectOps;
                    236: extern JS_FRIEND_DATA(JSObjectOps) js_WithObjectOps;
                    237: extern JSClass  js_ObjectClass;
                    238: extern JSClass  js_WithClass;
1.1.1.2 ! root      239: extern JSClass  js_BlockClass;
        !           240: 
        !           241: /*
        !           242:  * Block scope object macros.  The slots reserved by js_BlockClass are:
        !           243:  *
        !           244:  *   JSSLOT_PRIVATE       JSStackFrame *    active frame pointer or null
        !           245:  *   JSSLOT_BLOCK_DEPTH   int               depth of block slots in frame
        !           246:  *
        !           247:  * After JSSLOT_BLOCK_DEPTH come one or more slots for the block locals.
        !           248:  * OBJ_BLOCK_COUNT depends on this arrangement.
        !           249:  *
        !           250:  * A With object is like a Block object, in that both have one reserved slot
        !           251:  * telling the stack depth of the relevant slots (the slot whose value is the
        !           252:  * object named in the with statement, the slots containing the block's local
        !           253:  * variables); and both have a private slot referring to the JSStackFrame in
        !           254:  * whose activation they were created (or null if the with or block object
        !           255:  * outlives the frame).
        !           256:  */
        !           257: #define JSSLOT_BLOCK_DEPTH      (JSSLOT_PRIVATE + 1)
        !           258: 
        !           259: #define OBJ_BLOCK_COUNT(cx,obj) \
        !           260:     ((obj)->map->freeslot - (JSSLOT_BLOCK_DEPTH + 1))
        !           261: #define OBJ_BLOCK_DEPTH(cx,obj) \
        !           262:     JSVAL_TO_INT(OBJ_GET_SLOT(cx, obj, JSSLOT_BLOCK_DEPTH))
        !           263: #define OBJ_SET_BLOCK_DEPTH(cx,obj,depth) \
        !           264:     OBJ_SET_SLOT(cx, obj, JSSLOT_BLOCK_DEPTH, INT_TO_JSVAL(depth))
        !           265: 
        !           266: /*
        !           267:  * To make sure this slot is well-defined, always call js_NewWithObject to
        !           268:  * create a With object, don't call js_NewObject directly.  When creating a
        !           269:  * With object that does not correspond to a stack slot, pass -1 for depth.
        !           270:  *
        !           271:  * When popping the stack across this object's "with" statement, client code
        !           272:  * must call JS_SetPrivate(cx, withobj, NULL).
        !           273:  */
        !           274: extern JSObject *
        !           275: js_NewWithObject(JSContext *cx, JSObject *proto, JSObject *parent, jsint depth);
        !           276: 
        !           277: /*
        !           278:  * Create a new block scope object not linked to any proto or parent object.
        !           279:  * Blocks are created by the compiler to reify let blocks and comprehensions.
        !           280:  * Only when dynamic scope is captured do they need to be cloned and spliced
        !           281:  * into an active scope chain.
        !           282:  */
        !           283: extern JSObject *
        !           284: js_NewBlockObject(JSContext *cx);
        !           285: 
        !           286: extern JSObject *
        !           287: js_CloneBlockObject(JSContext *cx, JSObject *proto, JSObject *parent,
        !           288:                     JSStackFrame *fp);
        !           289: 
        !           290: extern JSBool
        !           291: js_PutBlockObject(JSContext *cx, JSObject *obj);
1.1       root      292: 
                    293: struct JSSharpObjectMap {
                    294:     jsrefcount  depth;
                    295:     jsatomid    sharpgen;
                    296:     JSHashTable *table;
                    297: };
                    298: 
                    299: #define SHARP_BIT       ((jsatomid) 1)
                    300: #define BUSY_BIT        ((jsatomid) 2)
                    301: #define SHARP_ID_SHIFT  2
1.1.1.2 ! root      302: #define IS_SHARP(he)    (JS_PTR_TO_UINT32((he)->value) & SHARP_BIT)
        !           303: #define MAKE_SHARP(he)  ((he)->value = JS_UINT32_TO_PTR(JS_PTR_TO_UINT32((he)->value)|SHARP_BIT))
        !           304: #define IS_BUSY(he)     (JS_PTR_TO_UINT32((he)->value) & BUSY_BIT)
        !           305: #define MAKE_BUSY(he)   ((he)->value = JS_UINT32_TO_PTR(JS_PTR_TO_UINT32((he)->value)|BUSY_BIT))
        !           306: #define CLEAR_BUSY(he)  ((he)->value = JS_UINT32_TO_PTR(JS_PTR_TO_UINT32((he)->value)&~BUSY_BIT))
1.1       root      307: 
                    308: extern JSHashEntry *
                    309: js_EnterSharpObject(JSContext *cx, JSObject *obj, JSIdArray **idap,
1.1.1.2 ! root      310:                     jschar **sp);
1.1       root      311: 
                    312: extern void
                    313: js_LeaveSharpObject(JSContext *cx, JSIdArray **idap);
                    314: 
1.1.1.2 ! root      315: /*
        !           316:  * Mark objects stored in map if GC happens between js_EnterSharpObject
        !           317:  * and js_LeaveSharpObject. GC calls this when map->depth > 0.
        !           318:  */
        !           319: extern void
        !           320: js_GCMarkSharpMap(JSContext *cx, JSSharpObjectMap *map);
        !           321: 
1.1       root      322: extern JSBool
                    323: js_obj_toSource(JSContext *cx, JSObject *obj, uintN argc, jsval *argv,
1.1.1.2 ! root      324:                 jsval *rval);
1.1       root      325: 
                    326: extern JSBool
                    327: js_obj_toString(JSContext *cx, JSObject *obj, uintN argc, jsval *argv,
1.1.1.2 ! root      328:                 jsval *rval);
        !           329: 
        !           330: extern JSBool
        !           331: js_HasOwnPropertyHelper(JSContext *cx, JSObject *obj, JSLookupPropOp lookup,
        !           332:                         uintN argc, jsval *argv, jsval *rval);
        !           333: 
        !           334: extern JSObject*
        !           335: js_InitBlockClass(JSContext *cx, JSObject* obj);
1.1       root      336: 
                    337: extern JSObject *
                    338: js_InitObjectClass(JSContext *cx, JSObject *obj);
                    339: 
                    340: /* Select Object.prototype method names shared between jsapi.c and jsobj.c. */
                    341: extern const char js_watch_str[];
                    342: extern const char js_unwatch_str[];
                    343: extern const char js_hasOwnProperty_str[];
                    344: extern const char js_isPrototypeOf_str[];
                    345: extern const char js_propertyIsEnumerable_str[];
                    346: extern const char js_defineGetter_str[];
                    347: extern const char js_defineSetter_str[];
                    348: extern const char js_lookupGetter_str[];
                    349: extern const char js_lookupSetter_str[];
                    350: 
                    351: extern void
                    352: js_InitObjectMap(JSObjectMap *map, jsrefcount nrefs, JSObjectOps *ops,
1.1.1.2 ! root      353:                  JSClass *clasp);
1.1       root      354: 
                    355: extern JSObjectMap *
                    356: js_NewObjectMap(JSContext *cx, jsrefcount nrefs, JSObjectOps *ops,
1.1.1.2 ! root      357:                 JSClass *clasp, JSObject *obj);
1.1       root      358: 
                    359: extern void
                    360: js_DestroyObjectMap(JSContext *cx, JSObjectMap *map);
                    361: 
                    362: extern JSObjectMap *
                    363: js_HoldObjectMap(JSContext *cx, JSObjectMap *map);
                    364: 
                    365: extern JSObjectMap *
                    366: js_DropObjectMap(JSContext *cx, JSObjectMap *map, JSObject *obj);
                    367: 
1.1.1.2 ! root      368: extern JSBool
        !           369: js_GetClassId(JSContext *cx, JSClass *clasp, jsid *idp);
        !           370: 
1.1       root      371: extern JSObject *
                    372: js_NewObject(JSContext *cx, JSClass *clasp, JSObject *proto, JSObject *parent);
                    373: 
1.1.1.2 ! root      374: /*
        !           375:  * Fast access to immutable standard objects (constructors and prototypes).
        !           376:  */
        !           377: extern JSBool
        !           378: js_GetClassObject(JSContext *cx, JSObject *obj, JSProtoKey key,
        !           379:                   JSObject **objp);
        !           380: 
        !           381: extern JSBool
        !           382: js_SetClassObject(JSContext *cx, JSObject *obj, JSProtoKey key, JSObject *cobj);
        !           383: 
        !           384: extern JSBool
        !           385: js_FindClassObject(JSContext *cx, JSObject *start, jsid id, jsval *vp);
        !           386: 
1.1       root      387: extern JSObject *
                    388: js_ConstructObject(JSContext *cx, JSClass *clasp, JSObject *proto,
                    389:                    JSObject *parent, uintN argc, jsval *argv);
                    390: 
                    391: extern void
                    392: js_FinalizeObject(JSContext *cx, JSObject *obj);
                    393: 
                    394: extern JSBool
                    395: js_AllocSlot(JSContext *cx, JSObject *obj, uint32 *slotp);
                    396: 
                    397: extern void
                    398: js_FreeSlot(JSContext *cx, JSObject *obj, uint32 slot);
                    399: 
                    400: /*
1.1.1.2 ! root      401:  * Native property add and lookup variants that hide id in the hidden atom
        !           402:  * subspace, so as to avoid collisions between internal properties such as
        !           403:  * formal arguments and local variables in function objects, and externally
        !           404:  * set properties with the same ids.
        !           405:  */
        !           406: extern JSScopeProperty *
        !           407: js_AddHiddenProperty(JSContext *cx, JSObject *obj, jsid id,
        !           408:                      JSPropertyOp getter, JSPropertyOp setter, uint32 slot,
        !           409:                      uintN attrs, uintN flags, intN shortid);
        !           410: 
        !           411: extern JSBool
        !           412: js_LookupHiddenProperty(JSContext *cx, JSObject *obj, jsid id, JSObject **objp,
        !           413:                         JSProperty **propp);
        !           414: 
        !           415: /*
1.1       root      416:  * Find or create a property named by id in obj's scope, with the given getter
                    417:  * and setter, slot, attributes, and other members.
                    418:  */
                    419: extern JSScopeProperty *
                    420: js_AddNativeProperty(JSContext *cx, JSObject *obj, jsid id,
                    421:                      JSPropertyOp getter, JSPropertyOp setter, uint32 slot,
                    422:                      uintN attrs, uintN flags, intN shortid);
                    423: 
                    424: /*
                    425:  * Change sprop to have the given attrs, getter, and setter in scope, morphing
                    426:  * it into a potentially new JSScopeProperty.  Return a pointer to the changed
                    427:  * or identical property.
                    428:  */
                    429: extern JSScopeProperty *
                    430: js_ChangeNativePropertyAttrs(JSContext *cx, JSObject *obj,
                    431:                              JSScopeProperty *sprop, uintN attrs, uintN mask,
                    432:                              JSPropertyOp getter, JSPropertyOp setter);
                    433: 
                    434: /*
                    435:  * On error, return false.  On success, if propp is non-null, return true with
                    436:  * obj locked and with a held property in *propp; if propp is null, return true
                    437:  * but release obj's lock first.  Therefore all callers who pass non-null propp
                    438:  * result parameters must later call OBJ_DROP_PROPERTY(cx, obj, *propp) both to
                    439:  * drop the held property, and to release the lock on obj.
                    440:  */
                    441: extern JSBool
                    442: js_DefineProperty(JSContext *cx, JSObject *obj, jsid id, jsval value,
1.1.1.2 ! root      443:                   JSPropertyOp getter, JSPropertyOp setter, uintN attrs,
        !           444:                   JSProperty **propp);
1.1       root      445: 
                    446: extern JSBool
                    447: js_DefineNativeProperty(JSContext *cx, JSObject *obj, jsid id, jsval value,
                    448:                         JSPropertyOp getter, JSPropertyOp setter, uintN attrs,
                    449:                         uintN flags, intN shortid, JSProperty **propp);
                    450: 
                    451: /*
                    452:  * Unlike js_DefineProperty, propp must be non-null.  On success, and if id was
                    453:  * found, return true with *objp non-null and locked, and with a held property
                    454:  * stored in *propp.  If successful but id was not found, return true with both
                    455:  * *objp and *propp null.  Therefore all callers who receive a non-null *propp
                    456:  * must later call OBJ_DROP_PROPERTY(cx, *objp, *propp).
                    457:  */
                    458: extern JS_FRIEND_API(JSBool)
                    459: js_LookupProperty(JSContext *cx, JSObject *obj, jsid id, JSObject **objp,
1.1.1.2 ! root      460:                   JSProperty **propp);
1.1       root      461: 
                    462: /*
                    463:  * Specialized subroutine that allows caller to preset JSRESOLVE_* flags.
1.1.1.2 ! root      464:  * JSRESOLVE_HIDDEN flags hidden function param/local name lookups, just for
        !           465:  * internal use by fun_resolve and similar built-ins.
1.1       root      466:  */
                    467: extern JSBool
                    468: js_LookupPropertyWithFlags(JSContext *cx, JSObject *obj, jsid id, uintN flags,
1.1.1.2 ! root      469:                            JSObject **objp, JSProperty **propp);
        !           470: 
        !           471: #define JSRESOLVE_HIDDEN        0x8000
1.1       root      472: 
                    473: extern JS_FRIEND_API(JSBool)
                    474: js_FindProperty(JSContext *cx, jsid id, JSObject **objp, JSObject **pobjp,
1.1.1.2 ! root      475:                 JSProperty **propp);
1.1       root      476: 
                    477: extern JSObject *
                    478: js_FindIdentifierBase(JSContext *cx, jsid id);
                    479: 
                    480: extern JSObject *
                    481: js_FindVariableScope(JSContext *cx, JSFunction **funp);
                    482: 
1.1.1.2 ! root      483: /*
        !           484:  * NB: js_NativeGet and js_NativeSet are called with the scope containing sprop
        !           485:  * (pobj's scope for Get, obj's for Set) locked, and on successful return, that
        !           486:  * scope is again locked.  But on failure, both functions return false with the
        !           487:  * scope containing sprop unlocked.
        !           488:  */
        !           489: extern JSBool
        !           490: js_NativeGet(JSContext *cx, JSObject *obj, JSObject *pobj,
        !           491:              JSScopeProperty *sprop, jsval *vp);
        !           492: 
        !           493: extern JSBool
        !           494: js_NativeSet(JSContext *cx, JSObject *obj, JSScopeProperty *sprop, jsval *vp);
        !           495: 
1.1       root      496: extern JSBool
                    497: js_GetProperty(JSContext *cx, JSObject *obj, jsid id, jsval *vp);
                    498: 
                    499: extern JSBool
                    500: js_SetProperty(JSContext *cx, JSObject *obj, jsid id, jsval *vp);
                    501: 
                    502: extern JSBool
                    503: js_GetAttributes(JSContext *cx, JSObject *obj, jsid id, JSProperty *prop,
1.1.1.2 ! root      504:                  uintN *attrsp);
1.1       root      505: 
                    506: extern JSBool
                    507: js_SetAttributes(JSContext *cx, JSObject *obj, jsid id, JSProperty *prop,
1.1.1.2 ! root      508:                  uintN *attrsp);
1.1       root      509: 
                    510: extern JSBool
                    511: js_DeleteProperty(JSContext *cx, JSObject *obj, jsid id, jsval *rval);
                    512: 
                    513: extern JSBool
                    514: js_DefaultValue(JSContext *cx, JSObject *obj, JSType hint, jsval *vp);
                    515: 
                    516: extern JSIdArray *
                    517: js_NewIdArray(JSContext *cx, jsint length);
                    518: 
1.1.1.2 ! root      519: /*
        !           520:  * Unlike realloc(3), this function frees ida on failure.
        !           521:  */
1.1       root      522: extern JSIdArray *
1.1.1.2 ! root      523: js_SetIdArrayLength(JSContext *cx, JSIdArray *ida, jsint length);
1.1       root      524: 
                    525: extern JSBool
                    526: js_Enumerate(JSContext *cx, JSObject *obj, JSIterateOp enum_op,
1.1.1.2 ! root      527:              jsval *statep, jsid *idp);
        !           528: 
        !           529: extern void
        !           530: js_MarkNativeIteratorStates(JSContext *cx);
1.1       root      531: 
                    532: extern JSBool
                    533: js_CheckAccess(JSContext *cx, JSObject *obj, jsid id, JSAccessMode mode,
1.1.1.2 ! root      534:                jsval *vp, uintN *attrsp);
1.1       root      535: 
                    536: extern JSBool
                    537: js_Call(JSContext *cx, JSObject *obj, uintN argc, jsval *argv, jsval *rval);
                    538: 
                    539: extern JSBool
                    540: js_Construct(JSContext *cx, JSObject *obj, uintN argc, jsval *argv,
1.1.1.2 ! root      541:              jsval *rval);
1.1       root      542: 
                    543: extern JSBool
                    544: js_HasInstance(JSContext *cx, JSObject *obj, jsval v, JSBool *bp);
                    545: 
                    546: extern JSBool
                    547: js_SetProtoOrParent(JSContext *cx, JSObject *obj, uint32 slot, JSObject *pobj);
                    548: 
                    549: extern JSBool
                    550: js_IsDelegate(JSContext *cx, JSObject *obj, jsval v, JSBool *bp);
                    551: 
                    552: extern JSBool
1.1.1.2 ! root      553: js_GetClassPrototype(JSContext *cx, JSObject *scope, jsid id,
        !           554:                      JSObject **protop);
1.1       root      555: 
                    556: extern JSBool
                    557: js_SetClassPrototype(JSContext *cx, JSObject *ctor, JSObject *proto,
1.1.1.2 ! root      558:                      uintN attrs);
1.1       root      559: 
                    560: extern JSBool
                    561: js_ValueToObject(JSContext *cx, jsval v, JSObject **objp);
                    562: 
                    563: extern JSObject *
                    564: js_ValueToNonNullObject(JSContext *cx, jsval v);
                    565: 
                    566: extern JSBool
                    567: js_TryValueOf(JSContext *cx, JSObject *obj, JSType type, jsval *rval);
                    568: 
                    569: extern JSBool
                    570: js_TryMethod(JSContext *cx, JSObject *obj, JSAtom *atom,
1.1.1.2 ! root      571:              uintN argc, jsval *argv, jsval *rval);
1.1       root      572: 
                    573: extern JSBool
                    574: js_XDRObject(JSXDRState *xdr, JSObject **objp);
                    575: 
                    576: extern uint32
                    577: js_Mark(JSContext *cx, JSObject *obj, void *arg);
                    578: 
                    579: extern void
                    580: js_Clear(JSContext *cx, JSObject *obj);
                    581: 
                    582: extern jsval
                    583: js_GetRequiredSlot(JSContext *cx, JSObject *obj, uint32 slot);
                    584: 
                    585: extern JSBool
                    586: js_SetRequiredSlot(JSContext *cx, JSObject *obj, uint32 slot, jsval v);
                    587: 
1.1.1.2 ! root      588: extern JSObject *
        !           589: js_CheckScopeChainValidity(JSContext *cx, JSObject *scopeobj, const char *caller);
        !           590: 
        !           591: extern JSBool
        !           592: js_CheckPrincipalsAccess(JSContext *cx, JSObject *scopeobj,
        !           593:                          JSPrincipals *principals, JSAtom *caller);
1.1       root      594: JS_END_EXTERN_C
                    595: 
                    596: #endif /* jsobj_h___ */

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.