Remet le pointeur interne de tableau au début

# reset

(PHP 4, PHP 5, PHP 7)

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

### Description

reset ( array `&$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.

### 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 boolean `FALSE` comme premier élément. Pour proprement vérifier la valeur du premier élément d'un tableu, 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