Adobe Extending Dreamweaver CS4 Manuale Utente Scaricare il pdf (Pagina 359)

353

EXTENDING DREAMWEAVER CS4

C-level extensibility

• The *pLengthargument is a pointer to an unsigned integer. This function sets *pLength equal to the length of the

string in bytes.

Returns

A pointer that points to a null-terminated UTF-8 string if successful, or to a null value on failure. The calling routine

must not free this string when it finishes.

JSBool JS_StringToValue()

Description

This function stores a string return value in a JSVal structure. It allocates a new JavaScript string object.

Arguments

JSContext *cx, JSVal *bytes, size_t sz, JSVal*vp

• The *cx argument is the opaque JSContext pointer that passes to the JavaScript function.

• The bytes argument is the string that Dreamweaver stores in the JSVal structure. The string data is copied, so the

caller must free the string when it is not needed. If the string size is not specified (see the

sz argument), the string

must be null-terminated.

• The sz argument is the size of the string, in bytes. If sz is 0, the length of the null-terminated string is computed

automatically.

• The *vp argument is a pointer to the JSVal structure into which the contents of the string is copied.

Returns

A Boolean value: JS_TRUE indicates success; JS_FALSE indicates failure.

JSBool JS_UCStringToValue()

Description

This function stores a string return value in a JSVal structure. It allocates a new JavaScript string object.

Arguments

JSContext *cx , JSVal *bytes, size_tsz, JSVal *vp

• The *cx argument is the opaque JSContext pointer that passes to the JavaScript function.

• The *bytes argument is the string that Dreamweaver stores in the JSVal structure. The string data is copied, so the

caller must free the string when it is not needed. If the string size is not specified (see the

sz argument), the string

must be null-terminated.

• The sz argument is the size of the string, in bytes. If sz is 0, the length of the null-terminated string is computed

automatically.

• The *vp argument is a pointer to the JSVal structure into which the contents of the string is copied.

Returns

A Boolean value: JS_TRUE indicates success; JS_FALSE indicates failure

1 2 ... 354 355 356 357 358 359 360 361 362 363 364 ... 386 387

Nessun commento

Adobe Extending Dreamweaver CS4 Manuale Utente Pagina 359