(PHP 4, PHP 5, PHP 7)
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.
array
Le 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.
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 boolean
FALSE
comme premier élément. Pour proprement vérifier la valeur du premier élément d'un tableu, 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().