A preg_split függvény

A preg_split függvény egy sztringet tömb elemekké oszt fel, reguláris kifejezést használva az elválasztók megtalálásához. Az első paraméterként egy reguláris kifejezést, a másodikként az eredeti sztringet fogad el. A harmadik, opcionális paraméter a tömb elemeinek számát határozza meg a végeredményben. A negyedik, opcionális paraméter olyan flag-eket határoz meg, amelyek megváltoztatják a függvény viselkedését.

Szintaxis

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

Flag-ek

Flag	Konstans	Leírás
`PREG_SPLIT_NO_EMPTY`	1	Csak a nem üres részeket adja vissza a felosztás után.
`PREG_SPLIT_DELIM_CAPTURE`	2	Elkapja és visszaadja a reguláris kifejezés részmintáinak egyezéseit.
`PREG_SPLIT_OFFSET_CAPTURE`	4	Minden visszaadott részhez hozzáadja annak pozícióját az eredeti sztringben.

Példa

Osszunk fel egy sztringet vesszők szerint:

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

A kód végrehajtásának eredménye:

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

Példa

Osszunk fel egy sztringet tetszőleges szóköz karakterek szerint az elemek számának korlátozásával:

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

A kód végrehajtásának eredménye:

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

Példa

A PREG_SPLIT_NO_EMPTY flag használata az üres elemek kizárására:

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

A kód végrehajtásának eredménye:

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

Lásd még

a preg_match függvényt,
amely reguláris kifejezésre keres
a explode függvényt,
amely egy sztringet egyszerű elválasztó szerint oszt fel