current

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

    current — Devuelve el elemento actual en un array

    Descripción

    current(array|object$array): mixed

    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.

    Historial de cambios

    VersiónDescripción
    7.0.0array 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.

    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: 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 boolfalse element. To properly traverse an array which may contain false 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 elementos false, ver la función foreach().

    Ver también

    • end() - Establece el puntero interno 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
    To Top