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

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.3.2 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. Pour les chaînes SJIS-mac (MacJapanese), les indices de caractères font désormais référence aux indices des points de code Unicode produits lorsque la chaîne est convertie en Unicode, lesquels diffèrent des indices de caractères pour les caractères SJIS-mac qui se convertissent en une séquence de plusieurs points de code.
8.0.0 encoding est désormais nullable.

Voir aussi