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. The functionality provided by this object is identical to that of the JavaScript Number object.

You must use the Number 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:

This is an example of calling the toString method of the Number object:

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

Returns a string containing the binary representation of the number 1234.

This is an example of calling the MIN_VALUE property (also called a constant) of the Number object:

smallest = Number.MIN_VALUE


 
Method summary for the Number object
Method Description

toString

Returns the string representation of a Number object.

valueOf

Returns the primitive value of a Number object.



 
Property summary for the Number object
Property Description

MAX_VALUE

Constant representing the largest representable number (double-precision IEEE-754). This number is approximately 1.7976931348623158e+308.

MIN_VALUE

Constant representing the smallest representable number (double-precision IEEE-754). This number is approximately 5e-324.

NaN

Constant representing the value for Not a Number (NaN).

NEGATIVE_INFINITY

Constant representing the value for negative infinity.

POSITIVE_INFINITY

Constant representing the value for positive infinity. This value is the same as the global variable Infinity.



 
Constructor for the Number object

Syntax

myNumber = new Number(value);

Arguments

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

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 an argument to a primitive value.

Player

Flash 5 or later.

Example

The following code constructs new Number objects:

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

See also

Number (function)