String()

Availability

Flash Player 4; behavior changed in Flash Player 7.

Usage

String(expression)

Parameters

expression An expression to convert to a string.

Returns

A string.

Description

Function; returns a string representation of the specified parameter as follows:

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 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.

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.

Note: Slash notation is not supported by ActionScript 2.0.

See also

Number.toString(), Object.toString(), String class, " " (string delimiter)