Função next() do PHP

Funções de Array PHP

Exemplo

Saída do valor do elemento atual e do próximo elemento do array:

<?php
$people = array("Bill", "Steve", "Mark", "David");
echo current($people) . "<br>";
echo next($people);
?>

Executar Exemplo

Definição e uso

A função next() move o ponteiro interno para o próximo elemento do array e sai.

Métodos relacionados:

  • prev() - Move o ponteiro interno para o elemento anterior do array e sai
  • current() - Retorna o valor do elemento atual do array
  • end() - Move o ponteiro interno para o último elemento do array e sai
  • reset() - Move o ponteiro interno para o primeiro elemento do array e sai
  • each() - Retorna o nome e o valor do elemento atual, movendo o ponteiro interno para frente

Sintaxe

next(array)
Parâmetros Descrição
array Obrigatório. Especifica o array a ser usado.

Explicação

next() e current() têm comportamento semelhante, com uma única diferença: antes de retornar o valor, move o ponteiro interno para frente. Isso significa que ele retorna o valor do próximo elemento do array e move o ponteiro do array para frente. Se o movimento do ponteiro ultrapassar o final do elemento do array, next() retorna FALSE.

Atenção:Se o array contiver unidades vazias ou cujos valores sejam 0, a função retornará FALSE ao encontrar essas unidades. Para percorrer corretamente um array que pode conter unidades vazias ou cujos valores sejam 0, consulte a função each().

Detalhes técnicos

Retorno: Se bem-sucedido, retorna o valor do próximo elemento do array. Se não houver mais elementos no array, retorna FALSE.
Versão PHP: 4+

Mais Exemplos

Exemplo 1

Demonstrar todos os métodos relacionados:

<?php
$people = array("Bill", "Steve", "Mark", "David");
echo current($people) . "<br>"; // O elemento atual é Bill
echo next($people) . "<br>"; // O próximo elemento de Bill é Steve
echo current($people) . "<br>"; // O elemento atual é Steve
echo prev($people) . "<br>"; // O elemento anterior a Steve é Bill
echo end($people) . "<br>"; // O último elemento é David
echo prev($people) . "<br>"; // O elemento anterior a David é Mark
echo current($people) . "<br>"; // O elemento atual é Mark
echo reset($people) . "<br>"; // Move o ponteiro interno para o primeiro elemento do array, ou seja, Bill
echo next($people) . "<br>"; // O próximo elemento de Bill é Steve
print_r (each($people)); // Retorna o nome e o valor do elemento atual (atualmente é Steve) e move o ponteiro interno
?>

Executar Exemplo

Funções de Array PHP