Funcția preg_split

Funcția preg_split împarte un șir de caractere în elemente de tablou, utilizând o expresie regulată pentru a căuta separatori. Primul parametru primește expresia regulată, al doilea - șirul sursă. Al treilea parametru opțional stabilește numărul de elemente ale tabloului în rezultatul final. Al patrulea parametru opțional stabilește steaguri care modifică comportamentul funcției.

Sintaxă

preg_split(pattern, subject, [limit], [flags]);

Steaguri

Steag	Constantă	Descriere
`PREG_SPLIT_NO_EMPTY`	1	Returnează doar părțile negoale după împărțire.
`PREG_SPLIT_DELIM_CAPTURE`	2	Capturează și returnează părțile care se potrivesc cu subșabloanele din expresia regulată.
`PREG_SPLIT_OFFSET_CAPTURE`	4	Pentru fiecare parte returnată adaugă poziția acesteia în șirul original.

Exemplu

Împărțim un șir de caractere după virgule:

<?php
	$res = preg_split('/,/', 'a,b,c,d,e');
	var_dump($res);
?>

Rezultatul executării codului:

['a', 'b', 'c', 'd', 'e']

Exemplu

Împărțim un șir de caractere după orice caractere de spațiu cu limitarea numărului de elemente:

<?php
	$res = preg_split('/\s+/', '1 2 3 4 5', 3);
	var_dump($res);
?>

Rezultatul executării codului:

['1', '2', '3 4 5']

Exemplu

Utilizarea steagului PREG_SPLIT_NO_EMPTY pentru a exclude elementele goale:

<?php
	$res = preg_split('/[,\s]/', 'a,b, c, ,d', -1, PREG_SPLIT_NO_EMPTY);
	var_dump($res);
?>

Rezultatul executării codului:

['a', 'b', 'c', 'd']

Vezi și

funcția preg_match,
care efectuează căutare după expresie regulată
funcția explode,
care împarte un șir de caractere după un separator simplu