# mb_substr

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

mb_substr — Lit une sous-chaîne

### Description

mb_substr(
string `$string`,
int `$start`,
?int `$length` = `null`,
?string `$encoding` = `null`
): string

Effectue une opération de type substr() basée sur le nombre de caractères. La position est celle depuis le début de la chaîne de caractères `string`. La position du premier caractère est `0`, le second, un, etc...

### Liste de paramètres

`string`

  La chaîne à extraire depuis la sous-chaîne.

`start`

  Si `start` est positif, la chaîne retournée commencera au caractère numéro `start`, dans la chaîne `string`. Le premier caractère est numéroté zéro. En effet, dans la chaîne '`abcdef`', le caractère à la position `0` est '`a`', le caractère à la position `2` est '`c`', et ainsi de suite.

  Si `start` est négatif, la chaîne retournée commencera au caractère numéro `start` à compter de la fin de la chaîne `string`.

`length`

  Nombre maximal de caractères à utiliser depuis `string`. Si ce paramètre est omis, ou vaut `NULL`, tous les caractères jusqu'à la fin de la chaîne seront extraits.

`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

mb_substr() retourne la portion de la chaîne `string` qui commence au caractère `start` et a la longueur de `length` caractères.

### Historique

Version | Description
--- | ---
8.0.0 | `encoding` est désormais nullable.

### Voir aussi

- mb_strcut() - Coupe une partie de chaîne
- mb_internal_encoding() - Lit/modifie l'encodage interne