JavaScript:SpiderMonkey:RegExp API
From MozillaWiki
JavaScript Regular Expression API [edit]
The purpose of this addition to the JS API is to make ECMA-262 compliant regular expression APIs available to C/C++ users. As with other JS API routines, clients are required to provide a properly initialized execution context (JSContext), and the API has the potential to throw JS exceptions, just as a script might.
Structures [edit]
JSObject</dt>
Used to track a JSRegExp, the structure of which we do not expose publically.</dd>
Routines [edit]
JSObject * JS_NewRegExpObjectFromString(JSContext *cx, const? JSString *str, uintN flags)</dt>
Used to build a JSObject which holds a precompiled regular expression to be used in future routines.
I also am not entirely clear on what "flat" does, can someone explain it to me? --Crowder 09:15, 31 August 2006 (PDT)</dd>
JSObject * JS_CloneRegExpObject(JSContext *cx, JSObject *obj, JSObject *parent)</dt>
Do we need this?</dd>
void JS_DestroyRegExpObject(JSContext *cx, JSObject *obj)</dt>
Used to destroy the object built with JS_NewRegExpObject.</dd>
JSBool JS_ExecuteRegExp(JSContext *cx, JSObject *re, const? JSString *input, JSBool test, jsval *rval)</dt>
Executes the expression compiled into re against input. test is a flag which dictates whether or not
we're actually interested in results beyond whether the expression matches or not (ie., for parenthesized parts of the
expression, $1, $2, and so on). The results returned in rval are with JSVAL_NULL, JS_TRUE (if we're only testing),
or a JSArray object containing the discovered result strings. If rval is an array, the 0-index value contains the results
of any substitutions that occurred.</dd>
JSObject * JS_NewRegExpObject(JSContext *cx, char *bytes, size_t length, uintN flags)</dt>
Already exists.
Wonder why bytes is not const? --Crowder 09:15, 31 August 2006 (PDT)</dd>
JSObject * JS_NewUCRegExpObject(JSContext *cx, jschar *chars, size_t length, uintN flags)</dt>
Already exists.</dd>
void JS_SetRegExpInput(JSContext *cx, JSString *input, JSBool multiline)</dt>
Already exists.</dd>
void JS_ClearRegExpStatics(JSContext *cx)</dt>
Already exists.</dd>
void JS_ClearRegExpRoots(JSContext *cx)</dt>
Already exists.</dd>
