(PHP 4, PHP 5, PHP 7, PHP 8)
reset — Reinicia el puntero interno del array al principio
reset() reemplaza el puntero del array
array al primer elemento y devuelve el valor
del primer elemento.
arrayEl array de entrada.
Devuelve el valor del primer elemento del array, o false si el array
está vacío.
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.
| Versión | Descripción |
|---|---|
| 8.1.0 | O bien convertir el objeto 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. |
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"
?>Nota: El valor devuelto para un array vacío no es distinguible del valor devuelto para un array que contiene un valor bool
falsecomo primer elemento. Para verificar correctamente el valor del primer elemento de un array, que puede contener un elementofalse, se debe primero verificar el count() del array, o verificar si la key() no esnull, después de haber llamado reset().