String Function - MACROMEDIA FLASH 8-FLASH LITE 2.X ACTIONSCRIPT LANGUAGE Reference

String function

String(expression:Object) : String
Returns a string representation of the specified parameter, as described in the following list:
If is a number, the return string is a text representation of the number.
■ expression
If is a string, the return string is
expression
■
If is an object, the return value is a string representation of the object
■ expression
generated by calling the string property for the object or by calling
no such property exists.
If is a Boolean value, the return string is
expression
■
If is a movie clip, the return value is the target path of the movie clip in slash
■ expression
(/) notation.
If is
expression undefined
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
■
Note:Slash notation is not supported by ActionScript 2.0.
Availability: ActionScript 1.0; Flash Lite 1.0 - Behavior changed in Flash Player 7.
Parameters
expression:Object
Returns
- A string.
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)
" string delimiter operator
, the return values are as follows:
- An expression to convert to a string.
,
toString (Object.toString method)
.
expression
Object.toString()
or
"true" "false"
undefined
if
.
.
,
String
Global Functions 85
,