mb_strimwidth

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

mb_strimwidthGet truncated string with specified width

Beschreibung

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

Truncates stringstring to specified width, where halfwidth characters count as 1, and fullwidth characters count as 2. See » http://www.unicode.org/reports/tr11/ for details regarding East Asian character widths.

Parameter-Liste

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.

Hinweis:

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

Der Parameter encoding legt die Zeichenkodierung fest. Wird er nicht übergeben, so wird die interne Zeichenkodierung genutzt.

Rückgabewerte

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

Changelog

VersionBeschreibung
8.3.0 Passing a negative width to mb_strimwidth() is now deprecated.
8.0.0encoding ist nun nullable (akzeptiert den null-Wert).
7.1.0 Support for negative starts and widths has been added.

Beispiele

Beispiel #1 mb_strimwidth() example

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

Siehe auch

To Top