Documentación offline PHP master

next

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

next

Avance el puntero interno de un array

Descripción#

next(array $array): mixed
```php

`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.

> [!WARNING]
> 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](#language.types.boolean) para más información. Utilice el [operador ===](#language.operators.comparison) 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 `object` 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](#book.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 con `next`

```php

Notas#

[!NOTE] 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.

Véase también#

current, end, prev, reset, each