MACROMEDIA DREAMWEAVER 8-EXTENDING DREAMWEAVER, Manual, Page: 467 / 504

The C-level API 467
■
Typically, this argument is passed in and converted using the
JS_ValueToObject()
function.
Returns
A pointer to a null-terminated string. The caller should not free this string when it finishes.
JSObject *JS_NewArrayObject()
Description
This function creates a new object that contains an array of
JSVals
.
Arguments
JSContext *cx
,
unsigned int length
,
jsval *v
■
The
cx
argument is the opaque
JSContext
pointer that passes to the JavaScript function.
■
The
length
argument is the number of elements that the array can hold.
■
The
v
argument is an optional pointer to the
jsvals
to be stored in the array. If the
return value is not
null
,
v
is an array that contains
length
elements. If the return value is
null
, the initial content of the array object is undefined and can be set using the
JS_SetElement()
function.
Returns
A pointer to a new array object or the value
null
upon failure.
long JS_GetArrayLength()
Description
Given a pointer to an array object, this function gets the number of elements in the array.
Arguments
JSContext *cx
,
JSObject *obj
■
The
cx
argument is the opaque
JSContext
pointer that passes to the JavaScript function.
■
The
obj
argument is a pointer to an array object.
Returns
The number of elements in the array or -1 upon failure.