Fonction preg_split() de PHP
Expressions régulières PHP (PCRE)
La fonction preg_split scinde une chaîne par une expression régulière.
Syntaxe
array preg_split ( string $pattern , string $subject [, int $limit = -1 [, int $flags = 0 ]] )
Scinde une chaîne donnée par une expression régulière.
Description des paramètres :
$pattern : Le motif à rechercher, sous forme de chaîne.
$subject : La chaîne d'entrée.
$limit: Facultatif. Si spécifié, limite le nombre de sous-chaînes renvoyées à au plus limite, et la dernière sous-chaîne contiendra toutes les parties restantes. Une valeur de limite de -1, 0 ou null signifie "aucune limite". Comme le veut la norme PHP, vous pouvez utiliser null pour ne pas définir de drapeaux.
$flags : Facultatif. Peut être toute combinaison des options suivantes (combinées avec l'opérateur OU binaire |) :
- PREG_SPLIT_NO_EMPTY : Si cette option est définie, preg_split() ne renverra que les parties non vides après la division.
- PREG_SPLIT_DELIM_CAPTURE : Si cette option est définie, les expressions entre parenthèses dans le motif du délimiteur seront capturées et renvoyées.
- PREG_SPLIT_OFFSET_CAPTURE : Si cette option est définie, pour chaque correspondance trouvée, le décalage de chaîne sera ajouté à la valeur de retour. Remarque : Cela modifiera chaque élément du tableau renvoyé, faisant de chaque élément un tableau constitué de l'élément 0 comme sous-chaîne divisée et de l'élément 1 comme décalage de la sous-chaîne dans subject.
Valeur de retour
Renvoie un tableau de sous-chaînes obtenues en divisant subject selon les limites correspondant au motif.
Exemples
Obtenir les parties de la chaîne recherchée
La sortie est la suivante :
Array
(
[0] => hypertext
[1] => language
[2] => programming
)
Diviser une chaîne en ses caractères constitutifs
La sortie est la suivante :
Array
(
[0] => r
[1] => u
[2] => n
[3] => o
[4] => o
[5] => b
)
Diviser une chaîne et obtenir le décalage de chaque partie
La sortie est la suivante :
Array
(
[0] => Array
(
[0] => hypertext
[1] => 0
)
[1] => Array
(
[0] => language
[1] => 10
)
[2] => Array
(
[0] => programming
[1] => 19
)
)
Autres extensions