Manual do PHP
Anterior |  | Próxima

# substr

(PHP 3, PHP 4, PHP 5)

substr -- Retorna uma parte de uma string

## Descrição

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

substr()retorna a parte de `string` especificada pelo parâmetro `start` e `length`.

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.

Exemplo 1. Uso basico de substr()
`<?php $rest = substr("abcdef", 1); // retorna "bcdef" $rest = substr("abcdef", 1, 3); // retorna "bcd" $rest = substr("abcdef", 0, 4); // retorna "abcd" $rest = substr("abcdef", 0, 8); // retorna "abcdef" // Outra opção é acessar atravéz de chaves $string = 'abcdef'; echo $string{0}; // retorna a echo $string{3}; // retorna d ?>`

Se `start` for negativo, a string retornada irá começar no caractere `start` a partir do fim de `string`.

Exemplo 2. Usando um inicio negativo
`<?php $rest = substr("abcdef", -1); // retorna "f" $rest = substr("abcdef", -2); // retorna "ef" $rest = substr("abcdef", -3, 1); // retorna "d" ?>`

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 3. 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" ?>`

Veja também strrchr(), substr_replace(), ereg() e trim().

Anterior | Principal | Próxima
substr_replace | Acima | trim