Number class

Availability

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

Description

The Number class is a simple wrapper object for the Number data type. You can manipulate primitive numeric values by using the methods and properties associated with the Number class. This class is identical to the JavaScript Number class.

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

The following example calls the toString() method of a 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 a Number object:

smallest = Number.MIN_VALUE

Method summary for the Number class

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 class

Property

Description

Number.MAX_VALUE

Constant representing the largest representable number (double-precision IEEE-754). This number is approximately 1.79E+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 class

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 a Number object. The new Number constructor is primarily used as a placeholder. A 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()