array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'function.current.php', 1 => 'current', ), 'up' => array ( 0 => 'ref.array.php', 1 => 'Funciones de Arrays', ), 'prev' => array ( 0 => 'function.count.php', 1 => 'count', ), 'next' => array ( 0 => 'function.each.php', 1 => 'each', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/array/functions/current.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 4, PHP 5, PHP 7, PHP 8)
current — Devuelve el elemento actual en un array
Cada array tiene un puntero interno a su elemento "actual", que es iniciado desde el primer elemento insertado en el array.
array
El array.
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
.
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 |
---|---|
7.0.0 |
array ahora siempre se pasa por el valor.
Antes de esta versión, se pasaba por referencia si era posible,
y por el valor de lo contrario.
|
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) { }
?>
Nota: The results of calling current() on an empty array and on an array, whose internal pointer points beyond the end of the elements, are indistinguishable from a bool
false
element. To properly traverse an array which may containfalse
elements, see the foreach() function. Los resultados al llamar current() en un array vacío y en un array, cuyo puntero interno apunta más allá del final de los elementos, son indistinguibles de un elemento de tipo boolfalse
. Para recorrer adecuadamente un array que puede contener elementosfalse
, ver la función foreach().