substr

(PHP 4, PHP 5)

substr — Retorna uma parte de uma string

Descrição

string substr ( string $string , int $start [, int $length ] )

Retorna a parte de string especificada pelo parâmetro start e length.

Parâmetros

string

A 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.

Example #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.

Example #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"
?>

Valor Retornado

Retorna a parte extraída da string.

Exemplos

Example #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

?>

Veja Também

  • strrchr() - Encontra a ultima ocorrência de um caractere em uma string
  • substr_replace() - Substitui o texto dentro de uma parte de uma string
  • preg_match() - Perform a regular expression match
  • trim() - Retira espaço no ínicio e final de uma string
  • mb_substr() - Get part of string
  • wordwrap() - Quebra uma string em um dado número de caracteres