(PHP 4, PHP 5, PHP 7, PHP 8)
current — Devuelve el elemento actual del array
Cada array mantiene un puntero interno, que se inicializa cuando se inserta el primer elemento en el array.
arrayEl array.
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.
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.
| Versión | Descripción |
|---|---|
| 8.1.0 | O bien convertir el objeto 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. |
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) { }
?>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 elementofalse, ver la estructura de controlforeach. 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 elementonull.
foreach