iconv_substr

(PHP 5, PHP 7, PHP 8)

iconv_substr — Отримання частини рядка

Опис

iconv_substr(    string $string,    int $offset,    ?int $length = null,    ?string $encoding = null): string|false

Отримує частину рядка string, визначену параметрами offsetиlength

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

string

Початковий рядок.

offset

Якщо offsetнеотрицателен,iconv_substr() отримує частину рядка string починаючи із символу з порядковим номером offset (Нумерація починається з нуля).

Якщо offsetотрицателен,iconv_substr() отримує частину рядка починаючи з позиції, що віддаляється від кінця рядка stringнаoffset символів.

length

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

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

encoding

Якщо параметр encoding не вказано, передбачається, що рядок string має кодування iconv.internal_encoding

Обратите внимание, что иoffset, иlength ґрунтуються на розмірі символу, розрахованого виходячи з кодування тексту (encoding), у той час як схожа функція substr() завжди розглядає їх побайтове усунення.

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

Повертає частину рядка string, визначену параметрами offsetиlength

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

список змін

Версия	Опис
8.0.0	lengthиencoding тепер допускають значення null.
7.0.11	Якщо string має довжину рівну offset, буде повернено порожній рядок. Раніше у таких випадках поверталося false

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

• substr() - Повертає підрядок
• mb_substr() - Повертає частину рядка
• mb_strcut() - Отримує частину рядка