MACROMEDIA FLASH 8-ACTIONSCRIPT 2.0 LANGUAGE, Reference

Page: 105 / 1378

Global Functions 105
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.
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(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