User Guide

Global Functions 85

String function

String(expression:Object) : String

Returns a string representation of the specified parameter, as described in the following list:

■ If expression is a number, the return string is a text representation of the number.

■ If expression is a string, the return string is expression.

■ If expression is an object, the return value is a string representation of the object

generated by calling the string property for the object or by calling

Object.toString() if

no such property exists.

■ If expression is a Boolean value, the return string is "true" or "false".

■ If expression is a movie clip, the return value is the target path of the movie clip in slash

(/) notation.

If expression is undefined, the return values are as follows:

■ In files published for Flash Player 6 or earlier, the result is an empty string ("").

■ In files published for Flash Player 7 or later, the result is undefined.

Note:Slash notation is not supported by ActionScript 2.0.

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

Parameters

expression:Object - An expression to convert to a string.

Returns

String - A string.

Example

In the following example, you use ActionScript to convert specified expressions to a string:

var string1:String = String("3");

var string2:String = String("9");

trace(string1+string2); // output: 39

Because both parameters are strings, the values are concatenated rather than added.