# 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é, 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 Asiatique 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éfinit, `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 `start`s et `width`s 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

- mb_strwidth() - Retourne la taille d'une chaîne
- mb_internal_encoding() - Lit/modifie l'encodage interne