tutoriais mais recente desenvolvimento web
 

PHP substr() Function

<PHP seqüência de referência

Exemplo

Retorno "world" da string:

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

Definição e Uso

O substr() retorna uma parte de uma string.

Note: Se o parâmetro de início é um número negativo e comprimento é menor ou igual para começar, comprimento se torna 0.

Sintaxe

substr( string,start,length )

Parâmetro Descrição
string Requeridos. Especifica a cadeia para retornar uma parte de
start Requeridos. Especifica onde começar na cadeia
  • Um número positivo - Comece em uma posição especificada na seqüência
  • Um número negativo - Comece em uma posição especificada a partir do final da string
  • 0 - Comece pelo primeiro caractere em seqüência
length Opcional. Especifica o comprimento da cadeia devolvida. O padrão é o fim da cadeia.
  • Um número positivo - O comprimento a ser devolvido a partir do parâmetro início
  • número negativo - O comprimento a ser devolvido a partir do final da string

Detalhes técnicos

Valor de retorno: Retorna a parte extraído de uma string, ou FALSE em caso de falha, ou uma string vazia
PHP Versão: 4+
changelog: Em PHP versão 5.2.2 a 5.2.6, se o parâmetro start indica a posição de um truncamento negativo ou além, FALSE é retornado. Outras versões obter a seqüência do início

mais Exemplos

Exemplo 1

Usando o parâmetro de início com diferentes números positivos e negativos:

<?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>";
?>
Exemplo executar »

exemplo 2

Utilizando os parâmetros de início e comprimento com diferentes números positivos e negativos:

<?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>";
?>
Exemplo executar »
<PHP seqüência de referência