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

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 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.0.0 encoding est désormais nullable.

Voir aussi