preg_split

preg_split -- Eclatement d'une chaîne par expression régulière.

Description

array preg_split ( string pattern, string subject [, int limit [, int flags]])

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 | ) :

PREG_SPLIT_NO_EMPTY

Si cette option est activée , seules les sous-chaînes non vides seront retournées par preg_split( ) .

PREG_SPLIT_DELIM_CAPTURE

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 .



Le paramètre flags a été ajouté en PHP Beta 3 .

Exemple 1 . Eclatement d ' une chaîne de recherche .

 
?php

 
/

 
/

 
scinde

 
la

 
phrase

 
grâce

 
aux

 
virgules

 
et

 
espacements

 
/

 
/

 
ce

 
qui

 
inclus

 
les

 
"

 
"

 
,

 
\r

 
,

 
\t

 
,

 
\n

 
et

 
\f

 
$keywords

 
=

 
preg_split

 
("

 
/

 
[\s

 
,]+

 
/

 
"

 
,

 
"langage

 
hypertexte

 
,

 
programmation")

 
;

 
?





Exemple 2 . Scinder une chaîne en caractères

 
?php

 
$str

 
=

 
'

 
string'

 
;

 
$chars

 
=

 
preg_split('

 
/

 
/'

 
,

 
$str

 
,

 
-1

 
,

 
PREG_SPLIT_NO_EMPTY)

 
;

 
print_r($chars)

 
;

 
?





Voir aussi explode( ) , spliti( ) , split( ) , implode( ) , preg_match( ) , preg_match_all( ) et preg_replace( ) .