Funkcja substr

Funkcja substr wycina i zwraca podciąg z ciągu. Sam ciąg przy tym nie ulega zmianie. Pierwszym parametrem funkcja przyjmuje ciąg, drugim - pozycję znaku, od której należy rozpocząć wycinanie, a trzecim - liczbę znaków. Pamiętaj, że numeracja znaków w ciągu zaczyna się od zera.

Drugi parametr może być ujemny - w tym przypadku odliczanie rozpocznie się od końca ciągu, przy czym ostatni znak będzie miał numer -1.

Trzeciego parametru można nie podawać - w tym przypadku wycinanie nastąpi do końca ciągu.

Funkcja poprawnie działa tylko ze znakami łacińskimi (znakami jednobajtowymi).

Składnia

substr(string $string, int $offset, ?int $length = null): string

Przykład

Wytnijmy 3 znaki z ciągu od pozycji 1 (od drugiego znaku, ponieważ pierwszy ma numer 0):

<?php
	echo substr('abcde', 1, 3);
?>

Wynik wykonania kodu:

'bcd'

Przykład

Wytnijmy wszystkie znaki do końca ciągu, zaczynając od drugiego (ma numer 1):

<?php
	echo substr('abcde', 1);
?>

Wynik wykonania kodu:

'bcde'

Przykład

Wytnijmy trzeci i drugi znak od końca, w tym celu podajemy początek wycinania -3 (to numer trzeciego znaku od końca), a liczbę znaków - 2:

<?php
	echo substr('abcde', -3, 2);
?>

Wynik wykonania kodu:

'cd'

Przykład

Wytnijmy 2 ostatnie znaki, w tym celu podajemy pozycję przedostatniego znaku (to -2), a trzeciego parametru nie podajemy - w takim przypadku cięcie będzie do końca ciągu:

<?php
	echo substr('abcde', -2);
?>

Wynik wykonania kodu:

'de'

Przykład

Wytnijmy ostatni znak:

<?php
	echo substr('abcde', -1);
?>

Wynik wykonania kodu:

'e'

Zobacz też

funkcję substr_replace,
która wycina fragment ciągu i zastępuje go innym