Please note, this is a STATIC archive of website developer.mozilla.org from November 2016, cach3.com does not collect or store any user information, there is no "phishing" involved.

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

Document Tags and Contributors

 Contributors to this page: arai, fscholz, Jorend, Lrascao, Rappo
 Last updated by: arai,