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