Lit une sous-chaîne

# mb_substr

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

mb_substr — Lit une sous-chaîne

### Description

mb_substr ( string `$str` , int `$start` [, int `$length` = NULL [, string `$encoding` = mb_internal_encoding() ]] ) : 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 `str`. La position du premier caractère est 0, le second, un, etc...

### Liste de paramètres

`str`

  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 `str`. 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, l'encodage de caractres interne sera utilisé.

### Valeurs de retour

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

### Historique

Version | Description
--- | ---
5.4.8 | Passer NULL en tant que `length` extrait tous les charactères jusqu'à la fin de la chaîne. Antérieur à cette version NULL était traité de la même manière que 0.

### Voir aussi

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