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.

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.

See also

toString (Number.toString method), toString (Object.toString method), String, " string delimiter operator