Avança o ponteiro interno de um array

(PHP 4, PHP 5, PHP 7)

next — Avança o ponteiro interno de um array

Descrição

mixed next ( array &$array )

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.

Parâmetros

array: O array a ser afetado.

Valor Retornado

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.

Aviso

Esta função pode retornar o booleano FALSE, mas também pode retornar um valor não-booleano que pode ser avaliado como FALSE, como 0 ou "". Leia a seção em Booleanos para maiores informações. Utilize o operador === para testar o valor retornado por esta função.

Exemplos

Exemplo #1 Exemplo de uso da 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';
?>

Notas

Nota: Você não estará hábil para distiguir o final de um array de um elemento boolean FALSE. Para corretamente percorrer um array que pode conter elementos FALSE, veja a função each().

Veja Também

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