Funkcja PHP preg_split()

Funkcja PHP preg_split() dzieli łańcuch znaków wg ciągu znaków pasującego do wzorca reprezentowanego przez wyrażenie regularne.

Przykład

Podział łańcucha za pomocą funkcji PHP preg_split().


$test = 'Ala ma kota';
print_r(preg_split('/\s/', $test));

Wynik:

Array
(
    [0] => Ala
    [1] => ma
    [2] => kota
)

Składnia funkcji PHP preg_split()

Funkcja PHP preg_split() ma następującą składnię:

preg_split(
    string $pattern,
    string $subject,
    int $limit = -1,
    int $flags = 0
): array|false

Parametry

Parametr	Opis
`pattern`	Parametr obowiązkowy. Wzorzec reprezentujący ciąg znaków, wg którego ma zostać podzielony łańcuch.
`subject`	Parametr obowiązkowy. Łańcuch znaków, który ma zostać podzielony.
`limit`	Określa maksymalną liczbę fragmentów łańcucha, jaka ma zostać zwrócona. Jeśli po jej wyczerpaniu pozostanie jeszcze jakaś część łańcucha, to zostaje ona zapisana w całości w ostatnim elemencie zwróconej tablicy. Wartość `-1` lub `0` oznacza brak ograniczenia.
`flags`	Dostępne są następujące flagi, które można łączyć bitowym operatorem \| (lub): `PREG_SPLIT_NO_EMPTY` Zwracane są tylko niepuste fragmenty. `PREG_SPLIT_DELIM_CAPTURE` Zwracane jest także wyrażenie w nawiasie znajdujące się we wzorcu ciągu rozdzielającego. `PREG_SPLIT_OFFSET_CAPTURE` Dla każdego zwróconego fragmentu dodatkowo zwracany jest indeks jego pozycji początkowej.

Wartość zwrotna

Funkcja PHP preg_split() zwraca tablicę, której elementami są fragmenty łańcucha podzielonego wg ciągu znaków reprezentowanego przez wzorzec wyrażenia regularnego, lub false.

Typ zwrotny: array|false.

Dodatkowy przykład

Poniżej znajduje się przykład użycia funkcji preg_split() z wszystkimi czterema argumentami wywołania.


$test = 'Ala ma kota';

print_r(preg_split('/\s/', $test, 2, PREG_SPLIT_OFFSET_CAPTURE));