Devuelve el elemento actual del array

# current

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

current — Devuelve el elemento actual del array

### Descripción

function current(array|object `$array`): mixed

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

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 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 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 de uso de current()

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

    $arr = array();
    var_dump(current($arr)); // bool(false)

    $arr = array(array());
    var_dump(current($arr)); // array(0) { }
    ?>

### Notas

> Nota: No es posible distinguir el final de un array o el resultado de la llamada current() sobre un array vacío, a partir del elemento bool `false`. Para recorrer correctamente un array que puede contener el elemento `false`, ver la estructura de control `foreach`. Para seguir utilizando current() y verificar correctamente si el valor es realmente un elemento del array, la key() del elemento current() debería compararse estrictamente diferente del elemento `null`.

### Ver también

- end() - Posiciona el puntero del array al final del array
- key() - Devuelve una clave de un array asociativo
- each() - Devuelve cada par clave/valor de un array
- prev() - Retrocede el puntero actual del array
- reset() - Reinicia el puntero interno del array al principio
- next() - Avance el puntero interno de un array
- `foreach`

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open