on NSPR. In fact, the JS C-engine no longer depends on NSPR at all in a single-threaded environment and the multi-threaded version relies on NSPR strictly for its threading primitives. This change was made for several reasons: + To merge the js/src and js/ref directories, which differ only in that the former is designed to link with NSPR2, but the latter makes use of an NSPR1 subset. The automatic generation of src from ref often led to confusion and sometimes to merge-related errors. + To avoid the requirement to link against multiple versions of NSPR when delivering JS binaries. (Different internal customers of JS have standardized upon different NSPR releases.) + To shield JS from incompatible changes to NSPR. Most of the changes involved simple renaming of types, macros, identifiers and file names, i.e. from pr* to js*. In some cases, this transformation resulted in name collisions and a different name was chosen. One place where renaming was *not* performed was in the definition of simple scalar types, i.e. int32, uint16, etc. The jsotypes.h header file was specially handled so as to avoid typename collision with NSPR types of the same name. git-svn-id: svn://10.0.0.236/branches/SpiderMonkey140_BRANCH@10585 18797224-902f-48f8-a5cc-f745e15eee43
279 lines
9.1 KiB
C
279 lines
9.1 KiB
C
/* -*- Mode: C; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 4 -*-
|
|
*
|
|
* The contents of this file are subject to the Netscape Public License
|
|
* Version 1.0 (the "NPL"); you may not use this file except in
|
|
* compliance with the NPL. You may obtain a copy of the NPL at
|
|
* http://www.mozilla.org/NPL/
|
|
*
|
|
* Software distributed under the NPL is distributed on an "AS IS" basis,
|
|
* WITHOUT WARRANTY OF ANY KIND, either express or implied. See the NPL
|
|
* for the specific language governing rights and limitations under the
|
|
* NPL.
|
|
*
|
|
* The Initial Developer of this code under the NPL is Netscape
|
|
* Communications Corporation. Portions created by Netscape are
|
|
* Copyright (C) 1998 Netscape Communications Corporation. All Rights
|
|
* Reserved.
|
|
*/
|
|
|
|
#ifndef jsatom_h___
|
|
#define jsatom_h___
|
|
/*
|
|
* JS atom table.
|
|
*/
|
|
#include <stddef.h>
|
|
#include "jstypes.h"
|
|
#ifndef NSPR20
|
|
#include "jshash.h"
|
|
#else
|
|
/* Removed by JSIFY: #include "JShash.h"
|
|
*/
|
|
#include "jshash.h" /* Added by JSIFY */
|
|
#endif
|
|
#include "jsapi.h"
|
|
#include "jsprvtd.h"
|
|
#include "jspubtd.h"
|
|
|
|
#ifdef JS_THREADSAFE
|
|
#include "jslock.h"
|
|
#endif
|
|
|
|
JS_BEGIN_EXTERN_C
|
|
|
|
#define ATOM_NOCOPY 0x01 /* don't copy atom string bytes */
|
|
#define ATOM_TMPSTR 0x02 /* internal, to avoid extra string */
|
|
#define ATOM_MARK 0x04 /* atom is reachable via GC */
|
|
#define ATOM_PINNED 0x08 /* atom is pinned against GC */
|
|
|
|
struct JSAtom {
|
|
JSHashEntry entry; /* key is jsval, value keyword info */
|
|
uint8 flags; /* flags, PINNED and/or MARK for now */
|
|
int8 kwindex; /* keyword index, -1 if not keyword */
|
|
jsatomid number; /* atom serial number and hash code */
|
|
};
|
|
|
|
#define ATOM_KEY(atom) ((jsval)(atom)->entry.key)
|
|
#define ATOM_IS_OBJECT(atom) JSVAL_IS_OBJECT(ATOM_KEY(atom))
|
|
#define ATOM_TO_OBJECT(atom) JSVAL_TO_OBJECT(ATOM_KEY(atom))
|
|
#define ATOM_IS_INT(atom) JSVAL_IS_INT(ATOM_KEY(atom))
|
|
#define ATOM_TO_INT(atom) JSVAL_TO_INT(ATOM_KEY(atom))
|
|
#define ATOM_IS_DOUBLE(atom) JSVAL_IS_DOUBLE(ATOM_KEY(atom))
|
|
#define ATOM_TO_DOUBLE(atom) JSVAL_TO_DOUBLE(ATOM_KEY(atom))
|
|
#define ATOM_IS_STRING(atom) JSVAL_IS_STRING(ATOM_KEY(atom))
|
|
#define ATOM_TO_STRING(atom) JSVAL_TO_STRING(ATOM_KEY(atom))
|
|
#define ATOM_IS_BOOLEAN(atom) JSVAL_IS_BOOLEAN(ATOM_KEY(atom))
|
|
#define ATOM_TO_BOOLEAN(atom) JSVAL_TO_BOOLEAN(ATOM_KEY(atom))
|
|
#define ATOM_BYTES(atom) JS_GetStringBytes(ATOM_TO_STRING(atom))
|
|
|
|
struct JSAtomListElement {
|
|
JSAtomListElement *next;
|
|
jsatomid index; /* index in script-specific atom map */
|
|
JSAtom *atom;
|
|
};
|
|
|
|
struct JSAtomList {
|
|
JSAtomListElement *list; /* literals indexed for mapping */
|
|
jsuint count; /* count of indexed literals */
|
|
};
|
|
|
|
#define ATOM_LIST_INIT(al) ((al)->list = NULL, (al)->count = 0)
|
|
|
|
#define ATOM_LIST_SEARCH(_ale,_al,_atom) \
|
|
JS_BEGIN_MACRO \
|
|
JSAtomListElement **_alep = &(_al)->list; \
|
|
while ((_ale = *_alep) != NULL) { \
|
|
if (_ale->atom == (_atom)) { \
|
|
/* Hit, move atom's element to the front of the list. */ \
|
|
*_alep = _ale->next; \
|
|
_ale->next = (_al)->list; \
|
|
(_al)->list = _ale; \
|
|
break; \
|
|
} \
|
|
_alep = &_ale->next; \
|
|
} \
|
|
JS_END_MACRO
|
|
|
|
struct JSAtomMap {
|
|
JSAtom **vector; /* array of ptrs to indexed atoms */
|
|
jsatomid length; /* count of (to-be-)indexed atoms */
|
|
};
|
|
|
|
struct JSAtomState {
|
|
JSRuntime *runtime; /* runtime that owns us */
|
|
JSHashTable *table; /* hash table containing all atoms */
|
|
jsatomid number; /* one beyond greatest atom number */
|
|
|
|
/* Type names and value literals. */
|
|
JSAtom *typeAtoms[JSTYPE_LIMIT];
|
|
JSAtom *booleanAtoms[2];
|
|
JSAtom *nullAtom;
|
|
|
|
/* Various built-in or commonly-used atoms. */
|
|
JSAtom *ArrayAtom;
|
|
JSAtom *MathAtom;
|
|
JSAtom *ObjectAtom;
|
|
JSAtom *anonymousAtom;
|
|
JSAtom *argumentsAtom;
|
|
JSAtom *arityAtom;
|
|
JSAtom *assignAtom;
|
|
JSAtom *calleeAtom;
|
|
JSAtom *callerAtom;
|
|
JSAtom *classPrototypeAtom;
|
|
JSAtom *constructorAtom;
|
|
JSAtom *countAtom;
|
|
JSAtom *indexAtom;
|
|
JSAtom *inputAtom;
|
|
JSAtom *lengthAtom;
|
|
JSAtom *nameAtom;
|
|
JSAtom *parentAtom;
|
|
JSAtom *protoAtom;
|
|
JSAtom *toSourceAtom;
|
|
JSAtom *toStringAtom;
|
|
JSAtom *valueOfAtom;
|
|
|
|
#ifdef JS_THREADSAFE
|
|
JSThinLock lock;
|
|
volatile uint32 tablegen;
|
|
#endif
|
|
};
|
|
|
|
/* Well-known predefined strings and their atoms. */
|
|
extern char *js_type_str[];
|
|
extern char *js_boolean_str[];
|
|
|
|
extern char js_Array_str[];
|
|
extern char js_Math_str[];
|
|
extern char js_Object_str[];
|
|
extern char js_anonymous_str[];
|
|
extern char js_arguments_str[];
|
|
extern char js_arity_str[];
|
|
extern char js_assign_str[];
|
|
extern char js_callee_str[];
|
|
extern char js_caller_str[];
|
|
extern char js_class_prototype_str[];
|
|
extern char js_constructor_str[];
|
|
extern char js_count_str[];
|
|
extern char js_eval_str[];
|
|
extern char js_index_str[];
|
|
extern char js_input_str[];
|
|
extern char js_length_str[];
|
|
extern char js_name_str[];
|
|
extern char js_parent_str[];
|
|
extern char js_proto_str[];
|
|
extern char js_toSource_str[];
|
|
extern char js_toString_str[];
|
|
extern char js_valueOf_str[];
|
|
|
|
/*
|
|
* Initialize atom state. Return true on success, false with an out of
|
|
* memory error report on failure.
|
|
*/
|
|
extern JSBool
|
|
js_InitAtomState(JSContext *cx, JSAtomState *state);
|
|
|
|
/*
|
|
* Free and clear atom state.
|
|
*/
|
|
extern void
|
|
js_FreeAtomState(JSContext *cx, JSAtomState *state);
|
|
|
|
/*
|
|
* Atom garbage collection hooks.
|
|
*/
|
|
typedef void
|
|
(*JSGCThingMarker)(JSRuntime *rt, void *thing);
|
|
|
|
extern void
|
|
js_MarkAtomState(JSAtomState *state, JSGCThingMarker mark);
|
|
|
|
extern void
|
|
js_SweepAtomState(JSAtomState *state);
|
|
|
|
extern void
|
|
js_UnpinPinnedAtoms(JSAtomState *state);
|
|
|
|
/*
|
|
* Find or create the atom for an object. If we create a new atom, give it the
|
|
* type indicated in flags. Return 0 on failure to allocate memory.
|
|
*/
|
|
extern JSAtom *
|
|
js_AtomizeObject(JSContext *cx, JSObject *obj, uintN flags);
|
|
|
|
/*
|
|
* Find or create the atom for a Boolean value. If we create a new atom, give
|
|
* it the type indicated in flags. Return 0 on failure to allocate memory.
|
|
*/
|
|
extern JSAtom *
|
|
js_AtomizeBoolean(JSContext *cx, JSBool b, uintN flags);
|
|
|
|
/*
|
|
* Find or create the atom for an integer value. If we create a new atom, give
|
|
* it the type indicated in flags. Return 0 on failure to allocate memory.
|
|
*/
|
|
extern JSAtom *
|
|
js_AtomizeInt(JSContext *cx, jsint i, uintN flags);
|
|
|
|
/*
|
|
* Find or create the atom for a double value. If we create a new atom, give
|
|
* it the type indicated in flags. Return 0 on failure to allocate memory.
|
|
*/
|
|
extern JSAtom *
|
|
js_AtomizeDouble(JSContext *cx, jsdouble d, uintN flags);
|
|
|
|
/*
|
|
* Find or create the atom for a string. If we create a new atom, give it the
|
|
* type indicated in flags. Return 0 on failure to allocate memory.
|
|
*/
|
|
extern JSAtom *
|
|
js_AtomizeString(JSContext *cx, JSString *str, uintN flags);
|
|
|
|
extern JS_FRIEND_API(JSAtom *)
|
|
js_Atomize(JSContext *cx, const char *bytes, size_t length, uintN flags);
|
|
|
|
extern JS_FRIEND_API(JSAtom *)
|
|
js_AtomizeChars(JSContext *cx, const jschar *chars, size_t length, uintN flags);
|
|
|
|
/*
|
|
* This variant handles all value tag types.
|
|
*/
|
|
extern JSAtom *
|
|
js_AtomizeValue(JSContext *cx, jsval value, uintN flags);
|
|
|
|
/*
|
|
* Convert v to an atomized string.
|
|
*/
|
|
extern JSAtom *
|
|
js_ValueToStringAtom(JSContext *cx, jsval v);
|
|
|
|
/*
|
|
* Assign atom an index and insert it on al.
|
|
*/
|
|
extern JSAtomListElement *
|
|
js_IndexAtom(JSContext *cx, JSAtom *atom, JSAtomList *al);
|
|
|
|
/*
|
|
* Get the atom with index i from map.
|
|
*/
|
|
extern JS_FRIEND_API(JSAtom *)
|
|
js_GetAtom(JSContext *cx, JSAtomMap *map, jsatomid i);
|
|
|
|
/*
|
|
* For all unmapped atoms recorded in al, add a mapping from the atom's index
|
|
* to its address. The GC must not run until all indexed atoms in atomLists
|
|
* have been mapped by scripts connected to live objects (Function and Script
|
|
* class objects have scripts as/in their private data -- the GC knows about
|
|
* these two classes).
|
|
*/
|
|
extern JS_FRIEND_API(JSBool)
|
|
js_InitAtomMap(JSContext *cx, JSAtomMap *map, JSAtomList *al);
|
|
|
|
/*
|
|
* Free map->vector and clear map.
|
|
*/
|
|
extern JS_FRIEND_API(void)
|
|
js_FreeAtomMap(JSContext *cx, JSAtomMap *map);
|
|
|
|
JS_END_EXTERN_C
|
|
|
|
#endif /* jsatom_h___ */
|