Funktio preg_split

Funktio preg_split jakaa merkkijonon taulukon elementeiksi käyttämällä säännöllistä lauseketta erottimien etsimiseen. Ensimmäisenä parametrina se ottaa säännöllisen lausekkeen, toisena - lähdemerkkijonon. Kolmas valinnainen parametri määrittää taulukon elementtien määrän lopputuloksessa. Neljäs valinnainen parametri määrittää liput, jotka muuttavat funktion käyttäytymistä.

Syntaksi

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

Liput

Lippu	Vakio	Kuvaus
`PREG_SPLIT_NO_EMPTY`	1	Palauttaa vain tyhjättömät osat jakamisen jälkeen.
`PREG_SPLIT_DELIM_CAPTURE`	2	Kaappaa ja palauttaa osat, jotka vastaavat säännöllisen lausekkeen alikuvioita.
`PREG_SPLIT_OFFSET_CAPTURE`	4	Lisää jokaiselle palautetulle osalle sen sijainnin alkuperäisessä merkkijonossa.

Esimerkki

Jaetaan merkkijono pilkkujen mukaan:

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

Koodin suorituksen tulos:

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

Esimerkki

Jaetaan merkkijono minkä tahansa whitespace-merkin mukaan elementtien määrän rajoituksella:

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

Koodin suorituksen tulos:

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

Esimerkki

Lipun PREG_SPLIT_NO_EMPTY käyttö tyhjien elementtien pois jättämiseksi:

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

Koodin suorituksen tulos:

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

Katso myös

funktion preg_match,
jonka suorittaa haun säännöllisellä lausekkeella
funktion explode,
jonka jakaa merkkijonon yksinkertaisen erottimen mukaan