Obsolete since JSAPI 32
This feature is obsolete. Although it may still work in some browsers, its use is discouraged since it could be removed at any time. Try to avoid using it.
Cast a jsval
to type JSString *
without a type check.
Syntax
JSString * JSVAL_TO_STRING(jsval v);
Description
JSVAL_TO_STRING
casts the argument, v
, to type JSString *
. As a precondition,
must be true. This function is not type-safe: if JSVAL_IS_STRING
(v)v
is not a string, the behavior is undefined.
To coerce any value to a string, use the JS_ValueToString
function instead. (The difference is that the latter will convert an object, array, number, or other value to a string in a type-safe way, creating a new string if needed.)
To convert the return type of this macro (JSString *
) to a char
pointer, use JS_GetStringBytes
.