Méthode split -- Le Coin Web de QuentinC

Vous êtes ici : Accueil > Référence HTML et JavaScript > Objet String > Méthode split

Méthode split

Description

Crée un tableau à partir d'une chaîne, en utilisant un séparateur (en anglais token) pour dissocier les différentes entrées du tableau.

Syntaxes

Array split(String token, [Integer maxTokens])
Array split(RegExp token, [Integer maxTokens])

Paramètres

token : Le séparateur à utiliser. Vous pouvez soit utiliser une expression régulière RegExp, soit une simple chaîne de caractères String.
Integer maxTokens : optionnel : Si ce paramètre est indiqué, split retournera un tableau de la longueur maximale indiquée, même si la chaîne peut être divisée davantage.

Valeur de retour

Retourne un tableau d'éléments correspondant au texte dissocié.

Exemples

Ce script utilise split avec une chaîne de caractères pour créer un tableau.

// On crée la chaîne de base
var chaine = "Voiture/Train/Bus/Bateau/Avion";

// On
utilise split pour crée un tableau contenant les véhicules. Le séparateur est ici "/".
var tab = chaine.split("/");

// et on affiche le résultat
alert("Nous
avons " + tab.length + " moyens de transport : " + tab.join(", ") + "");

Exécuter le script

Le script qui suit est capable d'extraire des données pour en faire un tableau avec presque n'importe quoi, grâce aux expressions régulières. Pour vous en convaincre, remplissez ce champ de texte et cliquez sur extraire pour voir ce que ça donne. Essayez de taper du texte, en séparant vos éléments soit par une virgule, soit par un point-virgule. Vous pouvez même choisir de mettre ou non des espaces avant et après les vérgules.

// On récupère le texte saisi dans la zone de texte
var chaine = document.forms["f"].elements["champ1"].value;

// On crée l'expression
régulière d'extraction
var reg = new RegExp("\\s*[,;]\\s*");

// On utilise split avec l'expression
var tab = chaine.split(reg);

//
et on affiche le résultat
alert("Votre chaîne a été séparée en " + tab.length + " éléments : " + tab.join(", ") + "");

Dans ces deux exemples, la fonction Array.join a été utilisée afin de transformer le tableau en chaîne lisible agréaglement.

Pour aller plus loin avec split

Split a une autre fonctionnalité très pratique et couramment utilisée. Dans l'exemple suivant, split est utilisé pour compter le nombre de mots d'une chaîne :

// On crée la chaîne de départ
var chaine = "Salut les amis, comment ça va ? Moi
pour ma part ça va bien.";

// On affiche le nombre de mots dans la chaine
alert("La chaîne " + chaine + " contient exactement " + chaine.split("
").length + " mots.");

Exécuter le script