spliti
(PHP 4 >= 4.0.1, PHP 5)
spliti — Scinde une chaîne en un tableau, grâce à une expression rationnelle
Avertissement
Cette fonction est OBSOLÈTE à partir de PHP 5.3.0 et a été
SUPPRIMÉE à partir de PHP 7.0.0.
Les alternatives à cette fonction incluent :
Description
spliti
( string $pattern
, string $string
[, int $limit
= -1
] ) : array
Cette fonction est identique à split(),
hormis le fait qu'elle ignore la casse pour les caractères alphabétiques.
Liste de paramètres
-
pattern
-
Expression rationnelle insensible à la casse.
Si vous voulez effectuer la césure avec un caractère qui est considéré
comme spécial par les expressions rationnelles, vous devez d'abord
l'échapper. Si vous pensez que la fonction spliti()
(ou tout autre fonction regex) fait quelque chose de bizarre,
lisez le fichier regex.7, inclus dans le sous-dossier
regex/ de la distribution PHP. Ce fichier est au format
man, vous devrez donc utiliser la commande
man /usr/local/src/regex/regex.7 pour le lire.
-
string
-
La chaîne d'entrée.
-
limit
-
Si limit
est défini, le tableau retourné
contiendra un maximum de limit
éléments,
dont le dernier élément contient le reste de la chaîne
string
.
Valeurs de retour
Retourne un tableau de chaînes, dont chaque élément est une
sous-chaîne de string
, formée par la césure
réalisée grâce 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 pas d'occurrence de pattern
, un tableau
avec un seul élément sera retourné. Évidemment, ceci est également vrai
si la chaîne string
est vide. Si une erreur survient,
spliti() retourne FALSE
.
Exemples
Scinder une chaîne en utilisant la lettre 'a' comme
séparateur :
Exemple #1 Exemple avec spliti()
<?php
$string = "aBBBaCCCADDDaEEEaGGGA";
$chunks = spliti ("a", $string, 5);
print_r($chunks);
?>
L'exemple ci-dessus va afficher :
Array
(
[0] =>
[1] => BBB
[2] => CCC
[3] => DDD
[4] => EEEaGGGA
)
Voir aussi
- preg_split() - Éclate une chaîne par expression rationnelle
- split() - Scinde une chaîne en un tableau, grâce à une expression rationnelle
- explode() - Scinde une chaîne de caractères en segments
- implode() - Rassemble les éléments d'un tableau en une chaîne