Fonction String

String(expression:Object) : String

Renvoie une chaîne représentant le paramètre spécifié, comme indiqué dans la liste suivante :

Si expression est un nombre, la chaîne renvoyée représente le nombre sous forme de texte.
Si expression est une chaîne, la chaîne renvoyée est expression.
Si expression est un objet, la valeur renvoyée est une chaîne représentant l'objet généré en appelant la propriété string de l'objet ou en appelant Object.toString() en l'absence de ce type de propriété.
Si expression est une valeur booléenne, la chaîne renvoyée est "true" ou "false".
Si expression est un clip, la valeur renvoyée est le chemin cible du clip avec la notation à barre oblique (/).

Si expression est undefined, la fonction renvoie l'une des valeurs suivantes :

Dans les fichiers publiés pour Flash Player 6 ou version précédente, le résultat est une chaîne vide (" ").
Dans les fichiers publiés pour Flash Player 7 ou version ultérieure, le résultat est undefined.

Remarque : La notation avec barre oblique n'est pas prise en charge par ActionScript 2.0.

Disponibilité : ActionScript 1.0 ; Flash Lite 1.0 - Comportement modifié dans Flash Player 7.

expression:Object - Une expression à convertir en chaîne.

String - Chaîne.

Dans l'exemple suivant, vous utilisez ActionScript pour convertir les expressions spécifiées en chaîne :

var string1:String = String("3");
var string2:String = String("9");
trace(string1+string2); // Sortie : 39

Etant donné que les deux paramètres sont des chaînes, les valeurs sont concaténées au lieu d'être ajoutées.