(PHP 4, PHP 5, PHP 7)
substr — Retorna uma parte de uma string
$string
, int $start
[, int $length
] )
Retorna a parte de string especificada pelo
parâmetro start e length.
stringA string de entrada.
start
Se start não for negativo, a string retornada iniciará
na posição start em
string, começando em zero. Por exemplo,
na string 'abcdef', o caractere na posição
0 é 'a', o
caractere na posição 2 é
'c', e assim em diante.
Se start for negativo, a string retornada
irá começar no caractere start
a partir do fim de string.
Exemplo #1 Usando um início negativo
<?php
$rest = substr("abcdef", -1); // retorna "f"
$rest = substr("abcdef", -2); // retorna "ef"
$rest = substr("abcdef", -3, 1); // retorna "d"
?>
length
Se length for dado e for positivo,
a string retornada irá conter length caracteres
começando em start (dependendo do tamanho de
string). Se a string é menor do
que start, será retornado FALSE.
Se length for dado e for negativo, então esta quantidade
caracteres serão omitidos do final de string
(após a posicão de inicio ter sido calculada quando
start for negativo). Se
start denota uma posição além da truncagem,
uma string vazia será retornada.
Exemplo #2 Usando um length negativo
<?php
$rest = substr("abcdef", 0, -1); // retorna "abcde"
$rest = substr("abcdef", 2, -1); // retorna "cde"
$rest = substr("abcdef", 4, -4); // retorna ""
$rest = substr("abcdef", -3, -1); // retorna "de"
?>
Retorna a parte extraída da string.
Exemplo #3 Uso básico da substr()
<?php
echo substr('abcdef', 1); // bcdef
echo substr('abcdef', 1, 3); // bcd
echo substr('abcdef', 0, 4); // abcd
echo substr('abcdef', 0, 8); // abcdef
echo substr('abcdef', -1, 1); // f
// Accessing single characters in a string
// can also be achived using "curly braces"
$string = 'abcdef';
echo $string{0}; // a
echo $string{3}; // d
echo $string{strlen($string)-1}; // f
?>