# reset

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

reset — Remet le pointeur interne de tableau au début

### Description

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

reset() replace le pointeur de tableau `array` au premier élément et retourne la valeur du premier élément.

### Liste de paramètres

`array`

  Le tableau d'entrée.

### Valeurs de retour

Retourne la valeur du premier élément du tableau, ou `false` si le tableau est vide.

Avertissement

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.

### Historique

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.

### Exemples

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"
?>`

### Notes

> 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 `false` comme premier élément. Pour proprement vérifier la valeur du premier élément d'un tableau, qui peut contenir un élément `false`, il faut d'abord vérifier le count() du tableau, ou vérifier si la key() n'est pas `null`, après avoir appelé reset().

### Voir aussi

- current() - Retourne l'élément courant du tableau
- each() - Retourne chaque paire clé/valeur d'un tableau
- end() - Positionne le pointeur de tableau en fin de tableau
- next() - Avance le pointeur interne d'un tableau
- prev() - Recule le pointeur courant de tableau
- array_key_first() - Récupère la première clé d'un tableau