Syntax

JSBool
JS_ValueToNumber(JSContext *cx, jsval v, jsdouble *dp);

Description

JS_ValueToNumber converts a JavaScript value to a number. It implements the ToNumber operator described in ECMA 262-3 §9.3.

• If v is already a number, conversion succeeds.
• If v is undefined, null, false, or true, conversion succeeds, and the result is NaN, 0, 0, or 1 respectively.
• If v is a string, conversion proceeds as specified in ECMA 262-3 §9.3.1. JS_ValueToNumber always succeeds in this case, returning JS_TRUE. If the string is not a numeric string, *dp is set to NaN.
• Otherwise v is an object. JS_ValueToNumber carries out the following steps to convert it to a number. If at any step an error or exception occurs, or conversion succeeds, the rest of the steps are skipped. (This behavior is implemented by v's JSObjectOps.defaultValue hook, so host objects can override it all.)
  • First, the object's JSClass.convert callback is called. For objects of standard classes, this is JS_ConvertStub, which simply calls v.valueOf() if present. If the convert callback produces a primitive value, the value is converted to a number as described above and conversion succeeds.
  • Otherwise, the resulting object's toString method, if any, is called. If that produces a primitive value, the value is converted to a number as described above and conversion succeeds.
  • Otherwise conversion fails with a TypeError.

On success, JS_ValueToNumber stores the converted value in *dp and returns JS_TRUE. On error or exception, it returns JS_FALSE, and the value left in *dp is undefined.

See Also

• JS_ConvertArguments
• JS_ConvertValue
• JS_GetTypeName
• JS_TypeOfValue
• JS_ValueToInt32
• JS_ValueToECMAInt32
• bug 884410