mb_strimwidth

(PHP 4 >= 4.0.6, PHP 5, PHP 7)

mb_strimwidth — Получение строки, обрезанной до заданного размера

Описание

mb_strimwidth ( string $str , int $start , int $width [, string $trimmarker = "" [, string $encoding = mb_internal_encoding() ]] ) : string

Обрезает строку (string) str до длины width символов.

Список параметров

str: Исходная строка.
start: Смещение от начала строки. Количество символов от начала строки (первый символ стоит в позиции 0). Если указано отрицательное число, то отсчет будет идти с конца строки.
width: Размер вырезаемой части в символах. Отрицательные значения отсчитываются с конца.
trimmarker: Строка, которая заместит конец обрезанной строки.
encoding: Параметр encoding представляет собой символьную кодировку. Если он опущен, вместо него будет использовано значение внутренней кодировки.

Возвращаемые значения

Обрезанная строка. Если задан четвёртый аргумент trimmarker, то его значением замещаются последние символы строки, так чтобы суммарный размер был не более width.

Список изменений

Версия	Описание
7.1.0	Добавлена поддержка отрицательных `start` и `width`.

Примеры

Пример #1 Пример использования mb_strimwidth()


<?php
echo mb_strimwidth("Hello World", 0, 10, "...");
// Выведет "Hello W..."
?>

Смотрите также

mb_strwidth() - Возвращает ширину строки
mb_internal_encoding() - Установка/получение внутренней кодировки скрипта

add a note

User Contributed Notes 4 notes

down

josiah dot ritchie at gmail dot com ¶

12 years ago


While having the option to append a string to the end is nice, you can run into the problem of having a space between the append if the width is truncated after a space. I find something like this to be more attractive in the output, although messy in the code.

rtrim(mb_strimwidth($string, 0, 24))."..."

down

-1

felixstar4 at gmail dot com ¶

2 years ago


Note that the trimmarker removes characters from the end of the string to trim, so

$hello = 'Lorem ipsum dolor sit amet, lorem ipsum';
$trimmarker = '......................';
echo mb_strimwidth($hello, 0, 20,  $trimmarker);
 
will only add the values of the trim marker, as the character number of $trimmarker is longer than the specified value to trim to, so it will return: 
 ......................
It is therefore better to use this: 
mb_strimwidth($hello, 0, 20). $trimmarker;
as the trimmarker won't remove characters of the string in order to make space for itself. It will return:
Lorem ipsum dolor si......................

down

-22

CBieser ¶

11 years ago


<?php

function strimwidthCenter( $value, $length = 40 ) {

    $valueEncoding = mb_detect_encoding( $value, 'auto', true );

    if ( $length >= mb_strwidth( $value, $valueEncoding ) ) {

        return $value;

    }

    $limited = '';

    $firstWidth = ceil( $length/2 );

    $secondStart = mb_strwidth( $value, $valueEncoding ) - ( $length - $firstWidth );

    $secondWidth = $length - $firstWidth +1;

    $limited = mb_strimwidth( $value, 0, $firstWidth, '...', $valueEncoding ) . mb_substr( $value, $secondStart, $secondWidth, $valueEncoding );

    return $limited;

}

?>

down

-64

Rich Mehta ¶

6 years ago


I had a problem (as in another comment) with a space being between the trailing dots and the subject being truncated. Here's how I fixed it:

<?php str_replace( " .", ".", mb_strimwidth( $subject, 0, 30, "..." ) ); ?>

add a note