Adobe Extending Dreamweaver CS4 - Manual (Page 357)

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.