iconv_substr

(PHP 5, PHP 7)

iconv_substrCoupe une partie de chaîne

Description

iconv_substr ( string $str , int $offset [, int $length = iconv_strlen($str, $charset) [, string $charset = ini_get("iconv.internal_encoding") ]] ) : string

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

Liste de paramètres

str

La chaîne de caractères originale.

offset

Si offset n'est pas négatif, iconv_substr() retourne le segment de str 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 str.

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 str 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.

charset

Si charset est omis, string est supposé avoir été encodée en iconv.internal_encoding.

Notez que offset et length sont toujours considérés comme représentant une position calculée sur la représentation ASCII des caractères déterminés par charset, contrairement à substr() qui se base toujours sur la position par octet.

Valeurs de retour

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

Si str est plus petit que offset, FALSE sera retourné. Si str est égal à offset charactères long, une chaîne de caractères vide sera retourné.

Historique

Version Description
7.0.11 Si str est égal à offset charactères long, une chaine vide sera retourné. Antérieur à cette version, FALSE était retourné dans ce cas.

Voir aussi