Avanza el puntero interno de un array

(PHP 4, PHP 5, PHP 7)

next — Avanza el puntero interno de un array

Descripción

mixed next ( array &$array )

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