array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'function.iconv-substr.php', 1 => 'iconv_substr', 2 => 'Coupe une partie de chaîne', ), 'up' => array ( 0 => 'ref.iconv.php', 1 => 'Fonctions iconv', ), 'prev' => array ( 0 => 'function.iconv-strrpos.php', 1 => 'iconv_strrpos', ), 'next' => array ( 0 => 'function.ob-iconv-handler.php', 1 => 'ob_iconv_handler', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', 'path' => 'reference/iconv/functions/iconv-substr.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

iconv_substr

(PHP 5, PHP 7, PHP 8)

iconv_substr — Coupe une partie de chaîne

Description

iconv_substr(
    string $string,
    int $offset,
    ?int $length = null,
    ?string $encoding = null
): string|false

Coupe une partie de la chaîne string à partir de la position offset et d'une longueur de length.

Liste de paramètres

string

La chaîne de caractères originale.

offset

Si offset n'est pas négatif, iconv_substr() retourne le segment de string en commençant au caractère numéro offset, en comptant à partir de zéro.

Si offset est négatif, iconv_substr() retourne le segment en commençant à la position offset caractères et en allant vers la fin de la chaîne de caractères string.

length

Si le paramètre length est donné et positif, la valeur retournée contiendra au plus length caractères de la portion de chaîne qui commence à offset (en fonction de la taille de la chaîne string).

Si length est passé et négatif, iconv_substr() coupe la portion externe de string depuis le caractère numéro offset jusqu'au caractère numéro length, compté depuis la fin de la chaîne de caractères. Dans le cas où offset est également négatif, la position de départ est calculée en amont, suivant la règle expliquée plus haut.

encoding

Si encoding est omis ou null, string est supposé avoir été encodé en iconv.internal_encoding.

Il est à noter que offset et length sont toujours considérés comme représentant des décalages calculés en fonction du jeu de caractères déterminé par encoding, tandis que la fonction équivalente substr() utilise toujours des décalages d'octets.

Valeurs de retour

Retourne la portion de string spécifiée par les paramètres offset et length.

Si string est plus petit que offset, false est retourné. Si string est égal à offset caractères long, une chaîne de caractères vide est retournée.

Historique

Version Description
8.0.0 length et encoding sont désormais nullable.
7.0.11 Si string est égal à offset caractères long, une chaîne vide sera retournée. Antérieur à cette version, false était retourné dans ce cas.

Voir aussi