(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.
array
El array de entrada.
Devuelve el valor del primer elemento del array, o false
si el array
está vacío.
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 |
---|---|
8.1.0 | Calling this function on objects is deprecated. Either convert the object to an array using get_mangled_object_vars() first, or use the methods provided by a class that implements Iterator, such as ArrayIterator, instead. |
7.4.0 | Instances of SPL classes are now treated like empty objects that have no properties instead of calling the Iterator method with the same name as this function. |
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
false
como 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().