mb_substr

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

mb_substrВозвращает часть строки

Описание

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

Корректно выполняет substr() для многобайтовых кодировок, учитывая количество символов. Позиция отсчитывается от начала str. Позиция первого символа - 0, второго - 1 и т.д.

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

str

Исходная строка для получения подстроки.

start

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

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

length

Максимальное количество символов возвращаемой из str подстроки. Если не указан или равен NULL - извлекаются все символы до конца строки.

encoding

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

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

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

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

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

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

  • mb_strcut() - Получение части строки
  • mb_internal_encoding() - Установка/получение внутренней кодировки скрипта