Forum und email

next

(PHP 4, PHP 5, PECL axis2:0.1.0-0.1.1 xmlreader:1.0-1.0.1)

next — Avança o ponteiro interno de um array

Descrição

mixed next ( array $array )

Retorna o elemento do array que está na próxima posição que é apontada pelo ponteiro interno do array, ou FALSE caso não existam mais elementos.

next() funciona de forma semelhante a current(), com uma diferença. Ele avança o ponteiro interno do array em uma posição antes de retornar o valor do elemento. Isso significa que ela retorna o próximo valor do array avançando o ponteiro interno em uma posição. Se o ponteiro interno apontar para além do final da lista de elementos , next() retorna FALSE.

Aviso

Se o array contiver elementos vazios, ou se elementos tiverem chaves com 0 como valor então essa função retorna FALSE para esses elementos. Para percorrer um array que pode conter elementos vazios ou elementos que tenham chaves com 0 como valor veja a função each().

Example#1 Exemplo de uso de next() e funções relacionadas

<?php 
  $transport 
= array('foot''bike''car''plane'); 
  
$mode current($transport); // $mode = 'foot'; 
  
$mode next($transport);    // $mode = 'bike'; 
  
$mode next($transport);    // $mode = 'car'; 
  
$mode prev($transport);    // $mode = 'bike'; 
  
$mode end($transport);     // $mode = 'plane'; 
  
?>

Veja também current(), end(), prev() e reset().