Reinicia el puntero interno del array al principio

# reset

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

reset — Reinicia el puntero interno del array al principio

### Descripción

function reset(array|object `&$array`): mixed

reset() reemplaza el puntero del array `array` al primer elemento y devuelve el valor del primer elemento.

### Parámetros

`array`

  El array de entrada.

### Valores devueltos

Devuelve el valor del primer elemento del array, o `false` si el array está vacío.

Advertencia

Esta función puede retornar `false`, pero también puede retornar un valor equivalente a `false`. Por favor, lea la sección sobre los booleanos para más información. Utilice el operador === para probar el valor de retorno exacto de esta función.

### Historial de cambios

Versión | Descripción
--- | ---
8.1.0 | O bien convertir el object en un array utilizando get_mangled_object_vars() primero, o utilizar los métodos proporcionados por una clase que implemente Iterator, tal como ArrayIterator.
7.4.0 | A partir de PHP 7.4.0, las instancias de clases SPL son tratadas como objetos vacíos sin propiedades en lugar de llamar al método Iterator con el mismo nombre que esta función.

### Ejemplos

Ejemplo #1 Ejemplo con reset()

    <?php

    $array = array('step one', 'step two', 'step three', 'step four');

    // Por omisión, el puntero está en el primer elemento
    echo current($array) . "<br />\n"; // "step one"

    // se saltan dos elementos
    next($array);
    next($array);
    echo current($array) . "<br />\n"; // "step three"

    // se reinicia el puntero al principio
    reset($array);
    echo current($array) . "<br />\n"; // "step one"

    ?>

### Notas

> Nota: El valor devuelto para un array vacío no es distinguible del valor devuelto para un array que contiene un valor bool `false` como primer elemento. Para verificar correctamente el valor del primer elemento de un array, que puede contener un elemento `false`, se debe primero verificar el count() del array, o verificar si la key() no es `null`, después de haber llamado reset().

### Ver también

- current() - Devuelve el elemento actual del array
- each() - Devuelve cada par clave/valor de un array
- end() - Posiciona el puntero del array al final del array
- next() - Avance el puntero interno de un array
- prev() - Retrocede el puntero actual del array
- array_key_first() - Recupera la primera clave de un array

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open