Jesus · Bible · HTML · CSS · JS · PHP · SVG · Applications

mb_strimwidth

Description

Get truncated string with specified width

Syntax

mb_strimwidth(
    string $string,
    int $start,
    int $width,
    string $trim_marker = "",
    ?string $encoding = null
): string

Parameters

string

The string being decoded.

start

The start position offset. Number of characters from the beginning of string (first character is 0), or if start is negative, number of characters from the end of the string.

width

The width of the desired trim. If negative width is specified, count from the end of the string.

NOTE: Passing negative width is deprecated as of PHP 8.3.0.

trim_marker

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 or null, the internal character encoding value will be used.

Return

The truncated string. If trim_marker is set, trim_marker replaces the last chars to match the width.

Examples

1 · string start · negative width · negative

<?

$string = 'string🐘string🐘string';
$start = -5;
$width = -10;

echo mb_strimwidth($string, $start, $width);

?>

2 · string start · negative width · non-negative

<?

$string = 'string🐘string🐘string';
$start = -5;
$width = 10;

echo mb_strimwidth($string, $start, $width);

?>
tring

3 · string start · non-negative width · negative

<?

$string = 'string🐘string🐘string';
$start = 5;
$width = -10;

echo mb_strimwidth($string, $start, $width);

?>
g🐘stri

4 · string start · non-negative width · non-negative

<?

$string = 'string🐘string🐘string';
$start = 5;
$width = 10;

echo mb_strimwidth($string, $start, $width);

?>
g🐘string

5 · trim_marker

<?

$string = 'string🐘string🐘string';
$start = 5;
$width = 10;
$trim_marker = '...';

echo mb_strimwidth($string, $start, $width, $trim_marker);

?>
g🐘stri...

6 · encoding

<?

$string = 'string🐘string🐘string';
$start = 5;
$width = 10;
$trim_marker = '...';
$encoding = 'UTF-8';

echo mb_strimwidth($string, $start, $width, $trim_marker, $encoding);

?>
g🐘stri...
HomeMenu