mb_strcut

(PHP 4 >= 4.0.6, PHP 5, PHP 7, PHP 8)

mb_strcut — Отримує частину рядка

Опис

mb_strcut(    string $string,    int $start,    ?int $length = null,    ?string $encoding = null): string

Функцияmb_strcut() вирізає підрядок з рядка також, як функція mb_substr()але оперує байтами замість символів. Якщо початок частини, що вирізається, потрапляє між байтами одного символу, функція виріже підрядок, починаючи з першого байта цього символу. Це суттєва відмінність від функції substr(), яка просто виріже підрядок, починаючи з середини символу, і цим порушить послідовність байтів у рядку.

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

string

Обрізний рядок.

start

Если значение параметраstart невід'ємний, повернутий рядок почнеться з позиції startвбайтахот начала строкиstringз нуля. Наприклад, у рядку «abcdef» байт у позиції - Це «a», байт у позиції c" і т.д.

Если значение параметраstart негативний рядок, що повертається, буде починатися з байта start зі зворотним відліком від кінця рядка string. Однак, якщо величина негативного start перевищує довжину рядка, частина, що повертається, почнеться з початку параметра string

length

Длина подстрокиу байтах. Якщо не вказано, то передається значення NULL і вирізають усі байти до кінця рядка.

Если значение параметраlength негативний рядок, що повертається, буде закінчуватися байтом length зі зворотним відліком від кінця рядка string. Однак, якщо величина негативного значення length перевищує кількість символів після позиції start, буде повернуто порожній рядок.

encoding

Параметрencoding - Це кодування символів. Якщо він опущений або дорівнює null, для нього буде встановлено внутрішнє кодування символів.

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

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

список змін

ВерсияОпис
8.0.0Тепер параметр encoding може набувати значення null

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

  • mb_substr() - Повертає частину рядка
  • mb_internal_encoding() - Встановлює/отримує внутрішнє кодування скрипту