User Guide

792 Chapter 2: ActionScript Language Reference

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

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.

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.