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

Описание

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() - Устанавливает или получает внутреннюю кодировку символов файла скрипта