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

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