iconv_substr
(PHP 5)
iconv_substr — Coupe une partie de chaîne
Description
$str
, int $offset
[, int $length
= iconv_strlen($str, $charset)
[, string $charset
= ini_get("iconv.internal_encoding")
]] )
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 destr
en commençant au caractère numérooffset
, en comptant à partir de zéro.Si
offset
est négatif, iconv_substr() retourne le segment en commençant à la positionoffset
caractères et en allant vers la fin de la chaîne de caractèresstr
. -
length
-
Si le paramètre
length
est donné et positif, la valeur retournée contiendra au pluslength
caractères de la portion de chaîne qui commence àoffset
(en fonction de la taille de la chaînestring
).Si
length
est passé et négatif, iconv_substr() coupe la portion externe destr
depuis le caractère numérooffset
jusqu'au caractère numérolength
, 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
etlength
sont toujours considérés comme représentant une position calculée sur la représentation ASCII des caractères déterminés parcharset
, 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é.
Voir aussi
- substr() - Retourne un segment de chaîne
- mb_substr() - Lit une sous-chaîne
- mb_strcut() - Coupe une partie de chaîne