Manual do PHP
Anterior |  | Próxima

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

Anterior | Principal | Próxima
natsort | Acima | pos