split
(PHP 4, PHP 5)
split — Scinde une chaîne en un tableau, grâce à une expression rationnelle
Cette fonction est devenue OBSOLÈTE en PHP 5.3.0, et a été SUPPRIMÉE en PHP 7.0.0.
Les alternatives à cette fonction incluent :
Description
$pattern
, string $string
[, int $limit = -1
] )
Scinde la chaîne string dans un tableau grâce
à une expression rationnelle.
Liste de paramètres
-
pattern -
Expression rationnelle sensible à la casse.
Si vous voulez utiliser n'importe quel caractère spécial des expressions rationnelles, vous devez les échapper. Si vous pensez que split() (ou toute autre expression rationnelle) se comporte bizarrement, lisez d'abord le fichier regex.7, inclus dans le dossier regex/ de la distribution PHP . Il est au format manpage, et vous pourrez le lire avec une commande telle que man /usr/local/src/regex/regex.7.
-
string -
La chaîne d'entrée.
-
limit -
Si
limitest défini, le tableau retourné contiendra un maximum delimitéléments avec le dernier élément contenant le reste de la chaînestring.
Valeurs de retour
Retourne un tableau de chaînes : chacune d'entre elle est une sous-chaîne de
string délimitée par les occurrences trouvées de
l'expression rationnelle pattern.
S'il y a n occurrences de
pattern, le tableau retourné
contiendra n+1 éléments.
Par exemple, s'il n'y a aucune occurrence de pattern,
un tableau d'un seul élément sera retourné. Bien sûr, cela reste vrai
si string est une chaîne vide. Si une erreur survient,
split() retournera FALSE.
Exemples
Exemple #1 Exemple avec split()
Pour scinder les 4 premiers champs d'une ligne du fichier /etc/passwd :
<?php
list($user, $pass, $uid, $gid, $extra) =
split(":", $passwd_line, 5);
?>
Exemple #2 Exemple avec split()
Pour analyser une date qui est délimitée par des /, des points ou des tirets :
<?php
// Les délimiteurs peuvent être des tirets, points ou slash
$date = "04/30/1973";
list($month, $day, $year) = split('[/.-]', $date);
echo "Mois : $month; Jour : $day; Année : $year<br />\n";
?>
Notes
split() est obsolète depuis PHP 5.3.0. Utilisez plutôt la fonction preg_split(). Si vous n'avez pas besoin de la puissance des expressions rationnelles, il est plus rapide d'utiliser explode(), qui n'utilise pas le moteur d'expressions rationnelles.
Pour les utilisateurs qui recherchent le moyen d'émuler la commande Perl @chars = split('', $str), voyez la fonction preg_split() ou la fonction str_split().
Voir aussi
- preg_split() - Éclate une chaîne par expression rationnelle
- spliti() - Scinde une chaîne en un tableau, grâce à une expression rationnelle
- str_split() - Convertit une chaîne de caractères en tableau
- explode() - Coupe une chaîne en segments
- implode() - Rassemble les éléments d'un tableau en une chaîne
- chunk_split() - Scinde une chaîne
- wordwrap() - Effectue la césure d'une chaîne
Document créé le 30/01/2003, dernière modification le 26/10/2018
Source du document imprimé : https://www.gaudry.be/php-rf-split.html
L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.
Références
Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.
