N-R > Number (object)

 

Number (object)

The Number object is a simple wrapper object for the number data type, which means that you can manipulate primitive numeric values using the methods and properties associated with the Number object. This object is identical to the JavaScript Number object. In Flash MX, the Number object has become a native object. As such, you will experience dramatic improvement in performance.

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

myNumber = 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 the toString and valueOf methods of the Number object. 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)