preg_split() retourne un tableau contenant les
sous-chaînes de subject
,
séparées par les chaînes qui vérifient
pattern
.
Si limit
est spécifié, alors seules les
limit
premières sous-chaînes sont retournées
et si limit
vaut -1, cela signifie en fait
"sans limite", ce qui est utile pour passer le paramètre
flags
.
flags
peut être la combinaison des
options suivantes (combinées avec l'opérateur |):
Si cette option est activée, seules les sous-chaînes non vides seront retournées par preg_split().
Si cette option est activée, les expressions entre parenthèses entre les délimiteurs de masques seront aussi capturées et retournées. Cette option a été ajoutée en PHP 4.0.5.
Si cette option est activée, pour chaque résultat, la position de celui-ci sera retournée.
Notez que cela change la valeur retournée en un tableau où chaque élément est un
tableau constitué de la chaîne trouvée à la position 0
et la position de la chaîne dans subject
à
la position 1.
Cette option est disponible depuis PHP 4.3.0.
Astuce : Si vous n'avez pas besoin de la puissance des expressions régulières, vous pouvez choisir des alternatives plus rapides (quoique plus simples) comme explode() ou str_split().
Note : Le paramètre
flags
a été ajouté en PHP 4 Bêta 3.
Voir aussi spliti(), split(), implode(), preg_match(), preg_match_all() et preg_replace().
Précédent | Sommaire | Suivant |
preg_replace | Niveau supérieur | Fonctions PDF |