Functie preg_split

De functie preg_split verdeelt een string in array-elementen door een reguliere expressie te gebruiken om scheidingstekens te vinden. Het accepteert een reguliere expressie als eerste parameter en de bronstring als tweede. Een derde optionele parameter specificeert het aantal array-elementen in het uiteindelijke resultaat. Een vierde optionele parameter specificeert flags die het gedrag van de functie veranderen.

Syntaxis

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

Flags

Flag	Constante	Beschrijving
`PREG_SPLIT_NO_EMPTY`	1	Retourneert alleen niet-lege delen na splitsing.
`PREG_SPLIT_DELIM_CAPTURE`	2	Vangt delen van de overeenkomst met subpatronen in de reguliere expressie op en retourneert ze.
`PREG_SPLIT_OFFSET_CAPTURE`	4	Voegt voor elk geretourneerd deel de positie ervan in de bronstring toe.

Voorbeeld

Laten we een string splitsen op komma's:

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

Resultaat van de code-uitvoering:

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

Voorbeeld

Laten we een string splitsen op elk witruimte-teken met een limiet op het aantal elementen:

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

Resultaat van de code-uitvoering:

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

Voorbeeld

Het gebruik van de PREG_SPLIT_NO_EMPTY flag om lege elementen uit te sluiten:

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

Resultaat van de code-uitvoering:

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

Zie ook

de functie preg_match,
die zoekt op basis van een reguliere expressie
de functie explode,
die een string splitst op een eenvoudig scheidingsteken