(PHP 5, PHP 7)
iconv_substr — Coupe une partie de chaîne
$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
.
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.
Retourne la portion de str
spécifié par les paramètres
offset
et length
.
Si str
est plus petit que offset
,
FALSE
sera retourné.