current

(PHP 4, PHP 5)

current — Devuelve el elemento actual en un array

Descripción

mixed current ( array &$array )

Cada array tiene un puntero interno a su elemento "actual", que es iniciado desde el primer elemento insertado en el array.

Parámetros

array: El array.

Valores devueltos

La función current() simplemente devuelve el valor del elemento del array que está siendo apuntado por el puntero interno. No desplaza el puntero de ninguna manera. Si el puntero interno apunta más allá del final de la lista de elementos o el array está vacío, current() devolverá 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.

Ejemplos

Ejemplo #1 Ejemplo de uso de current() y similares


<?php
$transport = array('pie', 'bici', 'coche', 'avión');
$mode = current($transport); // $mode = 'pie';
$mode = next($transport);    // $mode = 'bici';
$mode = current($transport); // $mode = 'bici';
$mode = prev($transport);    // $mode = 'pie';
$mode = end($transport);     // $mode = 'avión';
$mode = current($transport); // $mode = 'avión';

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

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

Notas

Nota: No hay manera de distinguir el inicio de un array de un elemento de tipo FALSE boolean. Para recorrer adecuadamente que puede contener elementos FALSE ver la función each().

Ver también

end() - Establece el puntero intero de un array a su último elemento
key() - Obtiene una clave de un array
each() - Devolver el par clave/valor actual de un array y avanzar el cursor del array
prev() - Rebobina el puntero interno del array
reset() - Establece el puntero interno de un array a su primer elemento
next() - Avanza el puntero interno de un array