current

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

currentDevuelve el elemento actual del array

Descripción

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 mueve el puntero. Si el puntero está más allá del último elemento de la lista, current() devuelve false.

Advertencia

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.

Historial de cambios

Versión Descripción
8.1.0 Calling this function on objects is deprecated. Either convert the object to an array 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.

Ejemplos

Ejemplo #1 Ejemplo de uso de current()

<?php
$transport
= array('foot', 'bike', 'car', 'plane');
$mode = current($transport); // $mode = 'foot';
$mode = next($transport); // $mode = 'bike';
$mode = current($transport); // $mode = 'bike';
$mode = prev($transport); // $mode = 'foot';
$mode = end($transport); // $mode = 'plane';
$mode = current($transport); // $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() en 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 continuar utilizando current() y verificar correctamente si el valor es realmente un elemento del array, la key() del elemento current() debería ser comparada 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