mb_strcut

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

mb_strcut — Получение части строки

Описание

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

mb_strcut() вырезает подстроку из строки также, как mb_substr(), но оперирует байтами вместо символов. Если начало вырезаемой части попадает между байтами одного символа, функция вырежет подстроку, начиная с первого байта этого символа. Это существенное отличие от substr(), которая просто вырежет подстроку, начиная с середины символа, и нарушит тем самым последовательность байт в строке.

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

string

Исходная строка.

start

Если start не отрицательное, возвращенная строка начнется с позиции start в байтах от начала string, начальный байт имеет индекс 0. К примеру, в строке 'abcdef', байт в позиции 0 - это 'a', байт в позиции 2 - 'c' и т.д.

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

length

Длина подстроки в байтах bytes. Если не указана, то передается NULL и вырезаются все байты до конца строки.

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

encoding

Параметр encoding представляет собой символьную кодировку. Если он опущен или равен null, вместо него будет использовано значение внутренней кодировки.

Возвращаемые значения

mb_strcut() возвращает часть строки string, заданную аргументами start и length.

Список изменений

Версия	Описание
8.0.0	Теперь параметр `encoding` может принимать значение `null`.

Смотрите также

mb_substr() - Возвращает часть строки
mb_internal_encoding() - Установка/получение внутренней кодировки скрипта