(PHP 4 >= 4.0.6, PHP 5, PHP 7, PHP 8)
mb_strimwidth — Получает строку, обрезанную до заданной ширины
$string,$start,$width,$trim_marker = "",$encoding = null
Обрезает строку (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..."
?>