Retrieve a floating-point infinity as a value of type JS::Value.

Syntax

// Added in SpiderMonkey 42
JS::Value
JS_GetPositiveInfinityValue(JSContext *cx);

JS::Value
JS_GetNegativeInfinityValue(JSContext *cx);

// Obsolete since SpiderMonkey 42
jsval
JS_GetPositiveInfinityValue(JSContext *cx);

jsval
JS_GetNegativeInfinityValue(JSContext *cx);
Name Type Description
cx JSContext * A context.

Description

JS_GetPositiveInfinityValue returns a JS::Value that represents an IEEE floating-point positive infinity. JS_GetNegativeInfinityValue returns the corresponding negative infinity.

Infinities are typically used to represent numbers that are greater in magnitude than the greatest representable finite values. As a value in mathematical calculations, an infinite value behaves like infinity. For example, any nonzero value multiplied by infinity is infinity with the expected sign, and any finite value divided by infinity is zero (again with the expected sign).

To get a floating-point NaN, use JS_GetNaNValue.

See Also