next

(PHP 4, PHP 5, PHP 7, PHP 8)

nextAvance el puntero interno de un array

Descripción

next(array|object &$array): mixed

next() se comporta como current(), con una diferencia. Avance el puntero interno del array un elemento, antes de devolver el valor del elemento. Esto significa que devuelve el próximo valor del array y avanza el puntero interno un elemento.

Parámetros

array

El array a tratar.

Valores devueltos

Devuelve el próximo valor del array siguiendo el puntero interno, o false si no hay más elementos.

Advertencia

Esta función puede retornar false, pero también puede retornar un valor equivalente a false. Por favor, lea la sección sobre los booleanos para más información. Utilice el operador === para probar el valor de retorno exacto de esta función.

Historial de cambios

Versión Descripción
8.1.0 O bien convertir el objeto en un array utilizando get_mangled_object_vars() primero, o utilizar los métodos proporcionados por una clase que implemente Iterator, tal como ArrayIterator.
7.4.0 A partir de PHP 7.4.0, las instancias de clases SPL son tratadas como objetos vacíos sin propiedades en lugar de llamar al método Iterator con el mismo nombre que esta función.

Ejemplos

Ejemplo #1 Ejemplo con next()

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

Notas

Nota: No es posible distinguir el final de un array del elemento bool false. Para recorrer correctamente un array que puede contener el elemento false, véase la función foreach. Para continuar utilizando next() y detectar correctamente si se ha alcanzado el final del array, la key() es null.

Ver también

  • current() - Devuelve el elemento actual del array
  • end() - Posiciona el puntero del array al final del array
  • prev() - Retrocede el puntero actual del array
  • reset() - Reinicia el puntero interno del array al principio
  • each() - Devuelve cada par clave/valor de un array