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 and earlier, the result is an empty string ("").
In files published for Flash Player 7 and later, the result is undefined.

Note: Slash notation is not supported by ActionScript 2.0.

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

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

String - A string.

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.