função substr() do PHP

Funções String PHP

instância

retorna "world" da string:

<?php
echo substr("Hello world",6);
?>

Executar Exemplo

definição e uso

a função substr() retorna uma parte da string.

comentário:se start o parâmetro é negativo e length menor ou igual a startentão length é 0.

sintaxe

class="language-php">substr(string,sta rt,length)
parâmetro descrição
string obrigatório. Determina a string de parte da qual retornar.
start

obrigatório. Determina onde começar na string.

  • número positivo - começa na posição especificada da string
  • número negativo - começa na posição especificada a partir do final da string
  • 0 - começa no primeiro caractere da string
length

opcional. Determina o comprimento da string a ser retornada. O padrão é até o final da string.

  • número positivo - a partir de start quantidade de caracteres retornada pela posição do parâmetro.
  • número negativo - retorna a quantidade de caracteres a partir do final da string.

Detalhes técnicos

Retorno: retorna a parte da string extraída, se falhar retorna FALSE, ou retorna uma string vazia.
Versão do PHP: 4+
Registro de atualizações:

nas versões do PHP de 5.2.2 a 5.2.6, se start se o parâmetro representar uma posição de truncamento negativo ou fora dos limites, retorna FALSE.

outras versões começam a partir de start começando pela posição.

Mais exemplos

Exemplo 1

Usar com números positivos e negativos diferentes start Parâmetros:

<?php
echo substr("Hello world",10)."<br>";
echo substr("Hello world",1)."<br>";
echo substr("Hello world",3)."<br>";
echo substr("Hello world",7)."<br>";
echo substr("Hello world",-1)."<br>";
echo substr("Hello world",-10)."<br>";
echo substr("Hello world",-8)."<br>";
echo substr("Hello world",-4)."<br>";
?>

Executar Exemplo

Exemplo 2

Usar com números positivos e negativos diferentes start e length Parâmetros:

<?php
echo substr("Hello world",0,10)."<br>";
echo substr("Hello world",1,8)."<br>";
echo substr("Hello world",0,5)."<br>";
echo substr("Hello world",6,6)."<br>";
echo substr("Hello world",0,-1)."<br>";
echo substr("Hello world",-10,-2)."<br>";
echo substr("Hello world",0,-6)."<br>";
echo substr("Hello world",-2-3)."<br>";
?>

Executar Exemplo

Funções String PHP