Macromedia dreamweaver 8-extending dreamweaver Manuale Utente

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 

 argument is the opaque 

JSContext

 pointer that passes to the JavaScript function.

■

The 

 argument is the number of elements that the array can hold.

■

The 

 argument is an optional pointer to the 

jsvals

 to be stored in the array. If the 

return value is not 

null

, 

 is an array that contains 

 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

 

■

The 

 argument is the opaque 

JSContext

 pointer that passes to the JavaScript function.

■

The 

 argument is a pointer to an array object.

Returns

The number of elements in the array or -1 upon failure.