(PHP 4, PHP 5, PHP 7, PHP 8)
reset — Remet le pointeur interne de tableau au début
Description
reset(array|object
&$array
): mixed
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
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