next

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

nextAvanza el puntero interno de un array

Descripción

next(array &$array): mixed

next() se comporta como current(), con una diferencia. Avanza el puntero interno un lugar a delante antes de devolver el valor del elemento. Esto significa que devuelve el siguiente valor del array y avanza el puntero interno del array un lugar.

Parámetros

array

El array afectado.

Valores devueltos

Devuelve el valor del array en el siguiente lugar que está apuntado por el puntero interno o false si no hay más elementos.

Advertencia

Esta función puede devolver el valor booleano false, pero también puede devolver un valor no booleano que se evalúa como false. Por favor lea la sección sobre Booleanos para más información. Use el operador === para comprobar el valor devuelto por esta función.

Ejemplos

Ejemplo #1 Ejemplo del uso de next() y similares

<?php
$transport 
= array('pie''bici''coche''avión');
$mode current($transport); // $mode = 'pie';
$mode next($transport);    // $mode = 'bici';
$mode next($transport);    // $mode = 'coche';
$mode prev($transport);    // $mode = 'bici';
$mode end($transport);     // $mode = 'avión';
?>

Notas

Nota: No hay manera de distinguir el inicio de un array de un elemento de tipo false boolean. Para recorrer adecuadamente que puede contener elementos false ver la función each().

Ver también

  • current() - Devuelve el elemento actual en un array
  • end() - Establece el puntero interno de un array a su último elemento
  • prev() - Rebobina el puntero interno del array
  • reset() - Establece el puntero interno de un array a su primer elemento
  • each() - Devolver el par clave/valor actual de un array y avanzar el cursor del array