JavaScript-1.5 Reference

JSVAL_TO_STRING Macro

Summary

Casts the type tag for a specified JS value and returns a pointer to the value cast as a JS string.

Syntax

JSVAL_TO_STRING(v)

Description

JSVAL_TO_STRING casts a specified JS value, v, to a JS string. It does so by casting the value's type tag and casting the result to a string pointer.

Casting v to a string pointer manipulate its underlying type tag. It does not convert the value stored in v to a different data type. To perform actual data type conversion, use the JS_ValueToString function.

Notes

This macro assumes that the JS type tag for v is already JSVAL_STRING. Because JS values are represented as bit-shifted C integers, comparisons of JSVAL_TO_STRING(v) to v itself are not equal unless you ignore the C pointer type mismatch and v is an object reference.

See Also

Groups [ Macro ]
Documents [ LXR ID Search ]
Entries [ DOUBLE_TO_JSVAL | JSVAL_TO_GCTHING | JSVAL_TO_OBJECT | JSVAL_TO_STRING | JS_ValueToString | OBJECT_TO_JSVAL | STRING_TO_JSVAL ]

This page was generated by APIDOC