(PHP 4 >= 4.0.1, PHP 5)
spliti — Scinde une chaîne en un tableau, grâce à une expression rationnelle
$pattern
, string $string
[, int $limit
= -1
] )
Scinde la chaîne string
dans un tableau,
par expression rationnelle.
Cette fonction est identique à split(), hormis le fait qu'elle ignore la casse pour les caractères alphabétiques.
Cette fonction est OBSOLETE depuis PHP 5.3.0. Nous vous encourageons vivement à ne plus l'utiliser.
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
.
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
.
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 )
Note:
À partir de PHP 5.3.0, l'extension regex est obsolète et vous devez utiliser l'extension PCRE à la place. Appeler des fonctions de l'extension regex émettra des alertes de type
E_DEPRECATED
. Voir la liste des différences pour vous aider dans la conversion en PCRE.