Lit une sous-chaîne

# mb_substr

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

mb_substr — Lit une sous-chaîne

### Description

function 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 depuis laquelle extraire 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.4.0 | Sur les chaînes invalides (celles comportant des erreurs d'encodage), les indices de caractères sont désormais interprétés de la même manière que la plupart des autres fonctions mbstring. Cela signifie que les indices de caractères retournés par mb_strpos() peuvent être passés directement.
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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open