array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.iconv-substr.php', 1 => 'iconv_substr', ), 'up' => array ( 0 => 'ref.iconv.php', 1 => 'iconv Funções', ), 'prev' => array ( 0 => 'function.iconv-strrpos.php', 1 => 'iconv_strrpos', ), 'next' => array ( 0 => 'function.iconv.php', 1 => 'iconv', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/iconv/functions/iconv-substr.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 5, PHP 7, PHP 8)
iconv_substr — Corta parte de uma string
$string
,$offset
,$length
= null
,$encoding
= null
Corta uma parte da string
especificada pelos parâmetros
offset
e length
.
string
A string original.
offset
Se offset
não for negativo,
iconv_substr() corta a parte da
string
começando no offset
'th
caractere, contando a partir de zero.
Se offset
for negativo,
iconv_substr() corta a parte que
começa na posição, desloca offset
caracteres
para longe do final da string
.
length
Se length
for fornecido e for positivo, o valor de
retorno conterá no máximo caracteres de length
da parte que começa no offset
(dependendo do comprimento da string
).
Se length
for negativo,
iconv_substr() cortará a parte da
string
desde o caractere offset
'th
até o caractere do length
final da string.
Caso offset
também seja negativo, a posição inicial
é calculada antecipadamente de acordo com a regra explicada acima.
encoding
Se o parâmetro encoding
for omitido ou null
,
presume-se que a string
esteja codificada em
iconv.internal_encoding.
Observe que os parâmetros offset
e length
são sempre considerados como representando deslocamentos que são
calculados com base no conjunto de caracteres determinado por
encoding
, enquanto a contraparte
substr() sempre os considera deslocamentos de byte.
Retorna a parte da string
especificada pelos
parâmetros offset
e length
.
Se string
for menor que os caracteres de offset
,
false
será retornado.
Se string
tiver exatamente o comprimento de caracteres de offset
,
uma string vazia será retornada.
Versão | Descrição |
---|---|
8.0.0 |
length e encoding são anuláveis agora.
|
7.0.11 |
Se string for igual
ao comprimento dos caracteres de offset , uma string
vazia será retornada. Antes desta versão, false era retornado neste caso.
|