(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..."
?>