(PHP 4, PHP 5, PHP 7, PHP 8)
reset — Remet le pointeur interne de tableau au début
reset() replace le pointeur de tableau
array au premier élément et retourne la valeur
du premier élément.
arrayLe tableau d'entrée.
Retourne la valeur du premier élément du tableau, ou false si le tableau
est vide.
Cette fonction peut retourner false, mais elle peut aussi retourner une valeur équivalent à false.
Veuillez lire la section sur les booléens pour plus d'informations.
Utilisez l'opérateur ===
pour tester la valeur de retour exacte de cette fonction.
| Version | Description |
|---|---|
| 8.1.0 | Soit convertir l'objet en un tableau en utilisant get_mangled_object_vars() d'abord, ou utiliser les méthodes fournies par une classe qui implémente Iterator, telle que ArrayIterator. |
| 7.4.0 | À partir de PHP 7.4.0, les instances de classes SPL sont traitées comme des objets vides sans propriétés au lieu d'appeler la méthode Iterator avec le même nom que cette fonction. |
Exemple #1 Exemple avec reset()
<?php
$array = array('step one', 'step two', 'step three', 'step four');
// Par défaut, le pointeur est sur le premier élément
echo current($array) . "<br />\n"; // "step one"
// on saute deux éléments
next($array);
next($array);
echo current($array) . "<br />\n"; // "step three"
// on remet le pointeur au début
reset($array);
echo current($array) . "<br />\n"; // "step one"
?>
Note: La valeur retournée pour un tableau vide n'est pas distinguable de la valeur retournée pour un tableau qui contient une valeur bool
falsecomme premier élément. Pour proprement vérifier la valeur du premier élément d'un tableau, qui peut contenir un élémentfalse, il faut d'abord vérifier le count() du tableau, ou vérifier si la key() n'est pasnull, après avoir appelé reset().