Flash 8 Documentation

ActionScript 2.0 Language Reference > ActionScript language elements > Global Functions > Number function

Number function

Number(expression) : Number

Converts the parameter expression to a number and returns a value as described in the following list:

• If expression is a number, the return value is expression.
• If expression is a Boolean value, the return value is 1 if expression is true, 0 if expression is false.
• If expression is a string, the function attempts to parse expression as a decimal number with an optional trailing exponent (that is, 1.57505e-3).
• If expression is NaN, the return value is NaN.
• If expression is undefined, the return value is as follows:
  - In files published for Flash Player 6 or earlier, the result is 0.
  
  - In files published for Flash Player 7 or later, the result is NaN.

Availability: ActionScript 1.0; Flash Player 4 - Behavior changed in Flash Player 7.

Parameters

expression:Object - An expression to convert to a number. Numbers or strings that begin with 0x are interpreted as hexadecimal values. Numbers or strings that begin with 0 are interpreted as octal values.

Returns

Number - A number or NaN (not a number).

Example

In the following example, a text field is created on the Stage at runtime:

this.createTextField("counter_txt", this.getNextHighestDepth(), 0, 0, 100, 22);
counter_txt.autoSize = true;
counter_txt.text = 0;
function incrementInterval():Void {
 var counter:Number = counter_txt.text;
 // Without the Number() function, Flash would concatenate the value instead 
 // of adding values. You could also use "counter_txt.text++;"
 counter_txt.text = Number(counter) + 1;
}
var intervalID:Number = setInterval(incrementInterval, 1000);

See also

NaN constant, Number, parseInt function, parseFloat function

Version 8

RSS feed | Send me an e-mail when comments are added to this page | Comment Report

Current page: http://livedocs.adobe.com/flash/8/main/00001750.html

Add Comment