mb_strcut

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

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

Описание

mb_strcut ( string $str , int $start [, int $length = NULL [, string $encoding = mb_internal_encoding() ]] ) : string

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

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

str

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

start

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

Если start отрицательное, возвращаемая строка начнется отсчитывая start байт с конца str.

length

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

encoding

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

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

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

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

Версия Описание
5.4.8 Передача NULL в ккачестве length вернет все байты до конца строки. В более ранних версиях NULL интерпретировался как 0.

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

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