Number object

Availability

Flash Player 5 (became a native object in Flash Player 6, which improved performance significantly).

Description

The Number object is a simple wrapper object for the number data type, which means that you can manipulate primitive numeric values by using the methods and properties associated with the Number object. This object is identical to the JavaScript Number object.

You must use a constructor when calling the methods of the Number object, but you do not need to use the constructor when calling the properties of the Number object. The following examples specify the syntax for calling the methods and properties of the Number object.

The following example calls the toString() method of the Number object, which returns the string "1234".

myNumber = new Number(1234);
myNumber.toString();

This example calls the MIN_VALUE property (also called a constant) of the Number object:

smallest = Number.MIN_VALUE

Method summary for the Number object

Method Description
Number.toString() Returns the string representation of a Number object.
Number.valueOf() Returns the primitive value of a Number object.

Property summary for the Number object

Property Description
Number.MAX_VALUE Constant representing the largest representable number (double-precision IEEE-754). This number is approximately 1.7976931348623158e+308.
Number.MIN_VALUE Constant representing the smallest representable number (double-precision IEEE-754). This number is approximately 5e-324.
Number.NaN Constant representing the value for Not a Number (NaN).
Number.NEGATIVE_INFINITY Constant representing the value for negative infinity.
Number.POSITIVE_INFINITY Constant representing the value for positive infinity. This value is the same as the global variable Infinity.

Constructor for the Number object

Availability

Flash Player 5.

Usage

new Number(value)

Parameters

value The numeric value of the Number object being created, or a value to be converted to a number.

Returns

Nothing.

Description

Constructor; creates a new Number object. You must use the Number constructor when using Number.toString() and Number.valueOf(). You do not use a constructor when using the properties of the Number object. The new Number constructor is primarily used as a placeholder. An instance of the Number object is not the same as the Number function that converts a parameter to a primitive value.

Example

The following code constructs new Number objects.

n1 = new Number(3.4);
n2 = new Number(-10);

See also

Number (function)