(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.
array
El 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
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.
Versión | Descripción |
---|---|
8.1.0 | Calling this function on objets is deprecated. Either convert the objet to an tableau using get_mangled_object_vars() first, or use the methods provided by a class that implements Iterator, such as ArrayIterator, instead. |
7.4.0 | Instances of SPL classes are now treated like empty objects that have no properties instead of calling the Iterator method with the same name as this function. |
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 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 elementonull
.