next

(PHP 3, PHP 4 , PHP 5)

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.

Atenção

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().

Exemplo 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().