mb_strimwidth
(PHP 4 >= 4.0.6, PHP 5, PHP 7)
mb_strimwidth — Получение строки, обрезанной до заданного размера
Описание
$string
, int $start
, int $width
, string $trim_marker = ""
, string|null $encoding = null
) : string
Обрезает строку (string) string
до длины width символов.
Список параметров
-
string -
Исходная строка.
-
start -
Смещение от начала строки. Количество символов от начала строки (первый символ стоит в позиции 0). Если указано отрицательное число, то отсчет будет идти с конца строки.
-
width -
Размер вырезаемой части в символах. Отрицательные значения отсчитываются с конца.
-
trim_marker -
Строка, которая заместит конец обрезанной строки.
-
encoding -
Параметр
encodingпредставляет собой символьную кодировку. Если он опущен или равенnull, вместо него будет использовано значение внутренней кодировки.
Возвращаемые значения
Обрезанная строка. Если задан четвёртый аргумент trim_marker,
то его значением замещаются последние символы строки, так чтобы суммарный размер был не более
width.
Список изменений
| Версия | Описание |
|---|---|
| 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() - Установка/получение внутренней кодировки скрипта