S > String.split

String.split

Disponibilité

Flash Player 5.

Usage

maChaîne.split("délimiteur", [limite])

Paramètres

délimiteur Le caractère ou la chaîne au niveau duquel maChaîne est scindée. Si le paramètre délimiteur est undefined, la chaîne tout entière est placée dans le premier élément du tableau.

limite Le nombre d'éléments à placer dans le tableau. Ce paramètre est facultatif.

Renvoie

Un tableau contenant les sous-chaînes de maChaîne.

Description

Méthode ; scinde un objet String en sous-chaînes à l'endroit où se trouve le paramètre délimiteur et renvoie les sous-chaînes dans un tableau. Si vous utilisez une chaîne vide ("") comme délimiteur, chaque caractère de la chaîne est placé en tant qu'élément dans le tableau, comme dans le code suivant.

maChaîne = "Joe";
i = maChaîne.split("");
trace (i);

La fenêtre Sortie affiche le contenu suivant :

J, O, E

Si le paramètre delimiter est undefined, la chaîne tout entière est placée dans le premier élément du tableau renvoyé.

Exemple

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

maChaîne = "P, A, T, S, Y";
maChaîne.split(",");

Cet exemple renvoie un tableau avec deux éléments.

maChaîne.split(",", 2);