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

# mb_substr

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

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

### Описание

function mb_substr(
string `$string`,
int `$start`,
?int `$length` = `null`,
?string `$encoding` = `null`
): string

Выполняет многобайтовую безопасную операцию substr(), основываясь на количестве символов. Позиция отсчитывается от начала строки (string) `string`. Позиция первого символа — 0, второго — 1 и т. д.

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

`string`

  Строка, из которой извлекается подстрока.

`start`

  Если значение параметра `start` неотрицательное, возвращённая строка начнётся с позиции `start` от начала строки `string`, считая с нуля. Например, в строке «`abcdef`», символ в позиции `0` — это «`a`», символ в позиции `2` — «`c`» и т. д.

  Если значение параметра `start` отрицательное, возвращаемая строка начнётся с `start`-го символа с конца строки `string`.

`length`

  Максимальное количество символов подстроки, возвращаемых из строки `string`. Если не указан или равен `NULL` — извлекаются все символы до конца строки.

`encoding`
  Параметр `encoding` указывает кодировку символов. При пропуске параметра или передаче значения `null` функция интерпретирует символы в предустановленной кодировке модуля.

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

Возвращает часть строки `string`, заданную параметрами `start` и `length`.

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

Версия | Описание
--- | ---
8.4.0 | Для некорректных строк (содержащих ошибки кодировки) индексы символов теперь интерпретируются так же, как и в большинстве других функций mbstring. Это означает, что индексы символов, которые возвращает функция mb_strpos(), можно передавать напрямую.
8.0.0 | Параметр `encoding` теперь принимает значение `null`.

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

- mb_strcut() - Получает часть строки
- mb_internal_encoding() - Устанавливает или получает внутреннюю кодировку символов файла скрипта

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open