(PHP 5, PHP 7)
iconv_substr — Elimina parte del string
$str
, int $offset
[, int $length
= iconv_strlen($str, $charset)
[, string $charset
= ini_get("iconv.internal_encoding")
]] )
Corta una parte de str
especificada por los
parámetros offset
y length
.
str
El string original.
offset
Si offset
no es negativo,
iconv_substr() elimina la porción de
str
que empieza en el caracter número
offset
, empezando de cero.
Si offset
es negativo,
iconv_substr() elimina la parte que empieza en esa
posición, offset
caracteres desde el final de
str
.
length
Si se da el parámetro length
y es positivo, el
valor retornado contendrá como mucho length
caracteres de la porción que comienza en offset
(dependiendo de la longitud de string
).
Si se indica un valor negativo en length
,
iconv_substr() elimina la porción de
str
desde la posición
offset
hasta el caracter que está
length
caracteres desde el final del string. En
caso de que offset
sea también negativo, la
posición de inicio se calcula de antemano de acuerdo con la regla
explicada anteriormente.
charset
Si se omite el parámetro charset
,
se asume que string
se codifica en
iconv.internal_encoding.
Notar que se considera que los parámetros offset
y
length
representan offsets que se calculan en
base a la codificación de caracteres determinada en
charset
, mientras que por otro lado,
substr() siempre los toma como offset de bytes.
Retorna la parte de str
especificada por los
parámetros offset
y length
i
Si str
tiene un tamaño más corto que
offset
, se retornará FALSE
.