split (méthode String.split)

public split(delimiter:String, [limit:Number]) : Array

Divise un objet String en sous-chaînes en le séparant aux endroits où le paramètre delimiter spécifié apparaît et renvoie les sous-chaînes dans un tableau. Si vous utilisez une chaîne vide ("") en tant que séparateur, chaque caractère dans la chaîne est placé comme un élément dans le tableau.

Si le paramètre delimiter n'est pas défini, l'ensemble de la chaîne est placé dans le premier élément du tableau renvoyé.

Disponibilité : ActionScript 1.0 ; Flash Lite 2.0

Paramètres

delimiter:String - Chaîne ; caractère ou chaîne à partir desquels my_str est divisé.

limit:Number [facultatif] - Nombre d'éléments à placer dans le tableau.

Valeur renvoyée

Array - Tableau contenant les sous-chaînes de my_str.

Exemple

L'exemple suivant renvoie un tableau avec cinq éléments :

var my_str:String = "P,A,T,S,Y";
var my_array:Array = my_str.split(",");
for (var i = 0; i<my_array.length; i++) {
    trace(my_array[i]);
}
// Renvoie :
    P
    A
    T
    S
    Y

L'exemple suivant renvoie un tableau avec deux éléments, "P" et "A":

var my_str:String = "P,A,T,S,Y";
var my_array:Array = my_str.split(",", 2);
trace(my_array); // Renvoie : P,A

L'exemple suivant indique que si vous utilisez une chaîne vide ("") en tant que paramètre delimiter les caractères de la chaîne sont placés dans le tableau en tant qu'éléments :

var my_str:String = new String("Joe");
var my_array:Array = my_str.split("");
for (var i = 0; i<my_array.length; i++) {
    trace(my_array[i]);
}
// Renvoie :
    J
    o
    e

Vous trouverez également un exemple dans le fichier Strings.fla du dossier HelpExamples. La liste suivante présente les chemins type vers ce dossier :

Voir aussi

join (méthode Array.join)