JS_ValueToBoolean 编辑

Obsolete since JSAPI 28
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.

Replaced by JS::ToBoolean

Convert any JavaScript value to a boolean value.

Syntax

JSBool
JS_ValueToBoolean(JSContext *cx, jsval v, JSBool *bp);

Description

JS_ValueToBoolean converts a specified JavaScript value, v, to a boolean value. It implements the ToBoolean operator specified in ECMA 262-3 §9.2. On success, JS_ValueToBoolean stores the converted value in *bp and returns JS_TRUE. On error or exception, it returns JS_FALSE, and the value left in *bp is undefined.

For versions greater than JSVERSION_1_2, all objects convert to JS_TRUE, even Boolean wrapper objects like the one produced by new Boolean(false). This is the behavior specified in ECMA 262-3 §9.2. See related discussion on Google Groups.

See Also

• MXR ID Search for JS_ValueToBoolean
• JS::ToBoolean
• bug 934557