« substr\_replacetrim »PHP ManualФункції для роботи з рядками

substr

(PHP 4, PHP 5, PHP 7, PHP 8)

substr — Повертає підрядок

Опис

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

Повертає рядок рядка string, що починається з offset символу за рахунком та довжиною length символів.

Список параметрів

string

Вхідний рядок.

offset

Якщо offset невід'ємний, підрядок, що повертається, починається з позиції offset від початку рядка, рахуючи від нуля. Наприклад, у рядку 'abcdef', у позиції знаходиться символ 'a', у позиції - символ 'c', і т.д.

Якщо offset негативний, повертається підрядок починається з позиції, що віддаляється на offsetсимволов от конца строкиstring

Якщо stringменьшеoffset символів буде повернено порожній рядок.

Приклад #1 Використання негативного параметра offset

Loading...

length

Якщо length позитивний рядок, що повертається, буде не довшим length символів, починаючи з параметра offset (залежно від довжини string

Якщо length негативний, то буде відкинуто зазначене цим аргументом кількість символів з кінця рядка string (після того як буде обчислено стартову позицію, якщо offset негативний). Якщо при цьому позиція почала підрядки, яка визначається аргументом offset, знаходиться у відкинутій частині рядка або за нею, повертається порожній рядок.

Якщо параметр length заданий і рівний , буде повернуто порожній рядок.

Якщо параметр lengthопущен или**null**, то буде повернуто підрядок, що починається з позиції, вказаної параметром offsetи длящейся до конца строки.

Приклад #2 Використання негативного параметра length

Loading...

Значення, що повертаються

Повертає вилучену частину параметра string або порожній рядок.

список змін

ВерсияОпис
8.0.0Параметрlength тепер допускає значення null. Якщо значення параметра length явно поставлено як null, функція повертає підрядок, що закінчується в кінці рядка; раніше повертався порожній рядок.
8.0.0Функція повертає порожній рядок там, де раніше повертала false

Приклади

Приклад #3 Базовое использованиеsubstr()****

Loading...

Приклад #4substr()и приведение типов

Loading...

Результат виконання наведеного прикладу:

1) 'pe'
2) '54'
3) 'gr'
4) '1'
5) ''
6) ''
7) '1200'

Приклад #5 Неприпустимий діапазон символів

Якщо запитується неприпустимий діапазон символів, substr() повертає порожній рядок, починаючи з PHP 8.0.0; раніше поверталося false

Loading...

Результат виконання наведеного прикладу в PHP 8:

string(0) ""

Результат виконання наведеного прикладу в PHP 7:

bool(false)

Дивіться також