Skip to main content

Visit Mozilla.org

Référence de JavaScript 1.5 Core:Objets globaux:String:split

Un article de MDC.


Sommaire

[modifier] Résumé

Éclate un objet String en un tableau de chaînes en séparant la chaîne en sous-chaînes.

Méthode de String
Implémenté dans : JavaScript 1.1, NES2.0
Version d'ECMAScript : ECMA-262 (si le séparateur est une chaîne)
ECMA-262, Edition 3 (si le séparateur est une expression rationnelle)

[modifier] Syntaxe

split([séparateur][, limite])

[modifier] Paramètres

séparateur 
spécifie le caractère à utiliser pour séparer la chaîne. Le séparateur est traité comme une chaîne ou une expression rationnelle. Si séparateur n'est pas précisé, le tableau renvoyé contient un seul élément consistant en la chaîne entière.
limite 
entier spécifiant une limite quant au nombre de morceaux à trouver.

[modifier] Description

La méthode split renvoie un nouveau tableau.

Lorsqu'il est trouvé, séparateur est retiré de la chaîne et les sous-chaînes sont renvoyées dans un tableau. Si séparateur n'est pas précisé, ce tableau contient un seul élément consistant en la chaîne entière.

Note : lorsque la chaîne est vide, split renvoie un tableau contenant une chaîne vide, plutôt qu'un tableau vide.

[modifier] Exemples

[modifier] Exemple : utilisation de split

L'exemple qui suit définit une fonction séparant une chaîne en un tableau de chaînes à l'aide du séparateur spécifié. Après avoir séparé la chaîne, la fonction affiche des messages indiquant la chaîne initiale (avant séparation), le séparateur utilisé, le nombre d'éléments dans le tableau et chacun de ces éléments. 

function splitString (stringToSplit,separator) {
   arrayOfStrings = stringToSplit.split(separator)
   document.write ('<P>La chaîne originale est : "' + stringToSplit + '"')
   document.write ('<BR>Le séparateur est : "' + separator + '"')
   document.write ("<BR>Le tableau contient " + arrayOfStrings.length + " éléments : ")

   for (var i=0; i < arrayOfStrings.length; i++) {
      document.write (arrayOfStrings[i] + " / ")
   }
}

var laTempete = "Ô splendide Nouveau Monde qui compte de pareils habitants !";
var lesMois = "Jan,Fév,Mar,Avr,Mai,Jun,Jul,Aôu,Sep,Oct,Nov,Déc";

var espace = " ";
var virgule = ",";

splitString(laTempete, espace);
splitString(laTempete);
splitString(lesMois, virgule);

Cet exemple produit l'affichage suivant : 

La chaîne originale est : "Ô splendide Nouveau Monde qui compte de pareils habitants !"
Le séparateur est : " "
Le tableau contient 10 éléments : Ô / splendide / nouveau / monde / qui / compte / de / pareils / habitants / ! /

La chaîne originale est : "Ô splendide Nouveau Monde qui compte de pareils habitants !"
Le séparateur est : "undefined"
Le tableau contient 1 éléments : Ô splendide Nouveau Monde qui compte de pareils habitants ! /

La chaîne originale est : "Jan,Fév,Mar,Avr,Mai,Jun,Jul,Aôu,Sep,Oct,Nov,Déc"
Le séparateur est : ","
Le tableau contient 10 éléments : Jan / Fév / Mar / Avr / Mai / Jun / Jul / Aoû / Sep / Oct / Nov / Déc /

[modifier] Exemple : enlever les espaces d'une chaîne

Dans l'exemple qui suit, split cherche 0 ou plusieurs espaces, suivis d'un point-virgule, suivi de 0 ou plusieurs espaces. Lorsqu'une telle séquence est trouvée, retire les espaces de la chaîne. nameList est le tableau renvoyé comme résultat de split. 

<script type="text/javascript">
var names = "Harry Trump ;Fred Barney; Helen Rigby ; Bill Abel ;Chris Hand ";
document.write(names + "<br>" + "<br>");
var re = /\s*;\s*/;
var nameList = names.split(re);
document.write(nameList);
</script>

Ceci affichera deux lignes. La première ligne est la chaîne originale et la seconde ligne le tableau résultant. 

Harry Trump ;Fred Barney; Helen Rigby ; Bill Abel ;Chris Hand
Harry Trump,Fred Barney,Helen Rigby,Bill Abel,Chris Hand

[modifier] Exemple : renvoi d'un nombre limité de morceaux

Dans l'exemple suivant, split cherche 0 ou plusieurs espaces dans une chaîne et renvoie les trois premiers morceaux trouvés. 

var myString = "Salut tout le monde. Comment vous allez ? ";
var splits = myString.split(" ", 3);
document.write(splits);

Ce script affiche la ligne suivante : 

["Salut", "tout", "le"]

[modifier] Voir aussi

charAt, indexOf, lastIndexOf, Array:join

Récupérée de « http://developer.mozilla.org/fr/docs/R%C3%A9f%C3%A9rence_de_JavaScript_1.5_Core:Objets_globaux:String:split »