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() - Встановлює/отримує внутрішнє кодування скрипту