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