Last updated: Mon, 23 Nov 2009

mb_strimwidth

(PHP 4 >= 4.0.6, PHP 5)

mb_strimwidth — Get truncated string with specified width

Description

string mb_strimwidth ( string $str , int $start , int $width [, string $trimmarker [, string $encoding ]] )

Truncates string str to specified width .

Parameters

str: The string being decoded.
start: The start position offset. Number of characters from the beginning of string. (First character is 0)
width: The width of the desired trim.
trimmarker: A string that is added to the end of string when string is truncated.
encoding: The encoding parameter is the character encoding. If it is omitted, the internal character encoding value will be used.

Return Values

The truncated string . If trimmarker is set, trimmarker is appended to the return value.

Examples

Example #1 mb_strimwidth() example


<?php
echo mb_strimwidth("Hello World", 0, 10, "...");
// outputs Hello W...
?>


<?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;


}


?>

josiah dot ritchie at gmail dot com
13-Sep-2007 06:48


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))."..."

add a note

mb_stripos

mb_strcut