Получает строку, обрезанную до заданной ширины

# mb_strimwidth

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

mb_strimwidth — Получает строку, обрезанную до заданной ширины

### Описание

function mb_strimwidth(
string `$string`,
int `$start`,
int `$width`,
string `$trim_marker` = "",
?string `$encoding` = `null`
): string

Обрезает строку (string), переданную в параметр `string`, до заданой в параметре `width` ширины символов, где символы половинной ширины рассчитываются как `1`, а символы полной ширины — как `2`. Подробнее о ширине восточноазиатских символов рассказано в приложении » http://www.unicode.org/reports/tr11/.

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

`string`

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

`start`

  Смещение от начала строки. Количество символов от начала строки (первый символ стоит в позиции 0). Если указано отрицательное число, то отсчёт будет идти с конца строки.

`width`

  Ширина, до которой необходимо обрезать строку. Если задано отрицательное значение ширины, отсчёт будет идти с конца строки.

  > Замечание:

  > Передача отрицательного значения ширины устарела с PHP 8.3.0.

`trim_marker`

  Строка, которая заместит конец обрезанной строки.

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

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

Возвращает обрезанную строку. Если задан четвёртый параметр `trim_marker`, то его значением замещаются символы в конце строки, так, чтобы суммарный размер был не более ширины `width`.

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

Версия | Описание
--- | ---
8.3.0 | Передача отрицательного значения в параметр `width` функции mb_strimwidth() устарела.
8.0.0 | Параметр `encoding` теперь принимает значение `null`.
7.1.0 | Добавлена поддержка отрицательных значений для параметров `start` и `width`.

### Примеры

Пример #1 Пример использования функции mb_strimwidth()

    <?php
    echo mb_strimwidth("Hello World", 0, 10, "...");
    // Выведет "Hello W..."
    ?>

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

- mb_strwidth() - Возвращает ширину строки
- mb_internal_encoding() - Устанавливает или получает внутреннюю кодировку символов файла скрипта

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