
351
EXTENDING DREAMWEAVER CS4
C-level extensibility
Arguments
JSContext *cx, JSVal v, unsigned integer *pLength
• The *cx argument is the opaque JSContext pointer that passes to the JavaScript function.
• The v argument is the JSVal structure from which Dreamweaver extracts the string.
• The *pLength argument 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 string if successful, or to a null value on failure. The calling routine must
not free this string when it finishes.
JSBool JS_ValueToInteger()
Description
This function extracts a function argument from a JSVal structure, converts it to an integer (if possible), and passes
the converted value back to the caller.
Arguments
JSContext *cx, JSVal v, long *lp
• The cx argument is the opaque JSContext pointer that passes to the JavaScript function.
• The v argument is the JSVal structure from which the integer is to be extracted.
• The lp argument is a pointer to a 4-byte integer. This function stores the converted value in *lp.
Returns
A Boolean value: JS_TRUE indicates success; JS_FALSE indicates failure.
JSBool JS_ValueToDouble()
Description
This function extracts a function argument from a JSVal structure, converts it to a double (if possible), and passes the
converted value back to the caller.
Arguments
JSContext *cx, JSVal v, double *dp
• The cx argument is the opaque JSContext pointer that passes to the JavaScript function.
• The v argument is the JSVal structure from which the double is to be extracted.
• The dp argument is a pointer to an 8-byte double. This function stores the converted value in *dp.
Returns
A Boolean value: JS_TRUE indicates success; JS_FALSE indicates failure.
Komentáře k této Příručce