JS_PushArguments 编辑

Obsolete since JavaScript 1.8.5
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.

Convert any number of arguments to jsvals and store the resulting jsvals in an array.

Syntax

jsval *
JS_PushArguments(JSContext *cx, void **markp, const char *format, ...);

jsval *
JS_PushArgumentsVA(JSContext *cx, void **markp, const char *format, va_list ap);

Description

JS_PushArguments provides a convenient way to translate a series of native C/C++ values to jsvals with a single function call.

cx is the context for the call. markp points to a void * to hold the internally allocated stack frame pointer to pass back to JS_PopArguments.

format is a sequential character array, where each element of the array indicates the JS type into which to convert the next C/C++ argument. format can contain one or more instances of the following characters, as appropriate:

This function also takes in consideration any additional custom types defined in cx using JS_AddArgumentFormatter.

For example, if format is "bIob", then there must be four arguments after format. Their types must be JSBool, jsdouble, JSObject *, and JSBool. If successful, JS_PushArguments would return a pointer to the first element of an array of four jsvals: a boolean, a number, an object (or null), and a boolean.

On success, JS_PushArguments fills in the supplied markp pointer and returns a pointer to the first element of an array of jsval which are automatically rooted as necessary (protected from the GC temporarily). The application must call JS_PopArguments using the supplied markp stack pointer when done with this stack frame, to free the memory and unroot the jsvals.

On error or exception, JS_PushArguments returns NULL.

To perform the opposite conversion, converting an array of jsvals to various native C types, use JS_ConvertArguments.

See Also

• JS_PopArguments
• bug 542091