array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'function.mb-strimwidth.php', 1 => 'mb_strimwidth', 2 => 'Tronque une chaîne', ), 'up' => array ( 0 => 'ref.mbstring.php', 1 => 'Fonctions sur les chaînes de caractères multioctets', ), 'prev' => array ( 0 => 'function.mb-strcut.php', 1 => 'mb_strcut', ), 'next' => array ( 0 => 'function.mb-stripos.php', 1 => 'mb_stripos', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', 'path' => 'reference/mbstring/functions/mb-strimwidth.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

mb_strimwidth

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

mb_strimwidth — Tronque une chaîne

Description

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

Tronque la chaîne string à la longueur width spécifiée, où les caractères à demi-chasse comptent en tant que 1, et les caractères à pleine chasse comptent en tant que 2. Voir » http://www.unicode.org/reports/tr11/ pour plus de détails concernant les chasses des caractères asiatiques de l'Est.

Liste de paramètres

string

La chaîne à tronquer.

start

start est la position de départ, en nombre de caractères depuis le début de la chaîne (premier caractère est 0), ou si la position est négative, nombre de caractères à partir de la fin de la chaîne de caractères.

width

La largeur de la troncation souhaitée. Si une largeur négative est spécifiée, il faut compter à partir de la fin de la chaîne.

Note:

Fournir une largeur négative est obsolète à partir de PHP 8.3.0.

trim_marker

trim_marker est la chaîne ajoutée à la fin de la chaîne tronquée.

encoding

Le paramètre encoding est l'encodage des caractères. S'il est omis ou null, l'encodage de caractères interne sera utilisé.

Valeurs de retour

La chaîne tronquée. Si trim_marker est défini, trim_marker remplace les derniers caractères pour correspondre à la taille width.

Historique

Version Description
8.3.0 Fournir une width négative à mb_strimwidth() est désormais obsolète.
8.0.0 encoding est désormais nullable.
7.1.0 Support pour starts et widths négatifs a été ajouté.

Exemples

Exemple #1 Exemple avec mb_strimwidth()

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

Voir aussi