current
En esta página
current
Devuelve el elemento actual del array
Descripción#
current(array $array): mixed
```php
Cada array mantiene un puntero interno, que se inicializa cuando se inserta el primer elemento en el array.
## Parámetros
`array`
El array.
## Valores devueltos
`current` solo devuelve el elemento actual apuntado por el puntero interno del array `array`. `current` no desplaza el puntero. Si el puntero está más allá del último elemento de la lista, `current` devuelve `false`.
> [!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 de uso de `current`
```php
Notas#
[!NOTE] No es posible distinguir el final de un array o el resultado de la llamada
currentsobre un array vacío, a partir del elementoboolfalse. Para recorrer correctamente un array que puede contener el elementofalse, ver la estructura de controlforeach.Para seguir utilizando
currenty verificar correctamente si el valor es realmente un elemento del array, lakeydel elementocurrentdebería compararse estrictamente diferente del elementonull.
Véase también#
end, key, each, prev, reset, next, foreach