reset

(PHP 4, PHP 5)

reset — Faz o ponteiro interno de um array apontar para o seu primeiro elemento

Descrição

mixed reset ( array &$array )

reset() retrocede o ponteiro interno de array para o primeiro elemento e retorna o valor do primeiro elemento do array, ou FALSE se o array for vazio.

Parâmetros

array

O array de entrada.

Valor Retornado

Retorna o valor do primeiro elemento do array, ou FALSE se o array estiver vazio.

Exemplos

Example #1 Exemplo da reset()

<?php  
  
$array = array('primero passo', 'segundo passo', 'terceiro passo', 'quarto passo');  
  
// por definição, o ponteiro está sobre o primeiro elemento  
echo current($array)."<br />\n"; // "Primeiro passo"
  
// pula dois passos  
next($array);  
next($array);  
echo current($array)."<br />\n"; // "passo três"  
  
// reinicia o ponteiro, começa novamente o primeiro passo  
reset($array);  
echo current($array)."<br />\n"; // "primeiro passo"  
  
?>

Veja Também

  • current() - Retorna o elemento corrente em um array
  • each() - Retorna o par chave/valor corrente de um array e avança o seu cursor
  • end() - Faz o ponteiro interno de um array apontar para o seu último elemento
  • next() - Avança o ponteiro interno de um array
  • prev() - Retrocede o ponteiro interno de um array