reset
En esta página
reset
Reinicia el puntero interno del array al principio
Descripción#
reset(array $array): mixed
```php
`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.
> [!WARNING]
> 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](#language.types.boolean) para más información. Utilice el [operador ===](#language.operators.comparison) 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](#book.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 con `reset`
\n"; // "step three" // se reinicia el puntero al principio reset($array); echo current($array) . "
\n"; // "step one" ?>
```php
Notas#
[!NOTE] El valor devuelto para un array vacío no es distinguible del valor devuelto para un array que contiene un valor
boolfalsecomo primer elemento. Para verificar correctamente el valor del primer elemento de un array, que puede contener un elementofalse, se debe primero verificar elcountdel array, o verificar si lakeyno esnull, después de haber llamadoreset.
Véase también#
current, each, end, next, prev, array_key_first