JSVAL_TO_STRING

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, JSVAL_IS_STRING(v) must be true. This function is not type-safe: if 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.

See Also