reset
(PHP 4, PHP 5, PHP 7, PHP 8)
reset — Setzt den internen Zeiger eines Arrays auf sein erstes Element
Beschreibung
reset() setzt den internen Zeiger von
array auf das erste Element zurück und gibt den Wert
des ersten Arrayelements zurück.
Parameter-Liste
-
array -
Das Eingabe-Array.
Rückgabewerte
Gibt das erste Element des Arrays zurück oder false wenn das Array leer
ist.
Diese Funktion kann sowohl das
boolsche false zurückliefern, als auch einen nicht-boolschen Wert, welcher zu false ausgewertet wird.
Weitere Informationen entnehmen Sie bitte dem Abschnitt über die
boolschen Typen. Benutzen Sie deshalb
den === Operator,
um den Rückgabewert dieser Funktion zu überprüfen.
Changelog
| Version | Beschreibung |
|---|---|
| 8.1.0 | Die Verwendung dieser Funktion bei Objekten ist veraltet. Entweder sollte zuerst get_mangled_object_vars() auf das Objekt angewendet werden oder sollte ArrayIterator verwendet werden. |
Beispiele
Beispiel #1 reset()-Beispiel
<?php
$array = array('step one', 'step two', 'step three', 'step four');
// normalerweise steht der interne Zeiger auf dem ersten Element
echo current($array) . "<br />\n"; // "step one"
// Zwei Elemente überspringen
next($array);
next($array);
echo current($array) . "<br />\n"; // "step three"
// Zeiger zurücksetzen auf das erste Element und wieder bei step one beginnen
reset($array);
echo current($array) . "<br />\n"; // "step one"
?>
Anmerkungen
Hinweis: Der Rückgabewert für ein leeres Array ist nicht zu unterscheiden vom Rückgabewert eines Arrays, das ein bool
falseals erstes Element hat. Um den Wert des ersten Elements eines Arrays ordnungsgemäß zu prüfen, dasfalse-Elemente enthalten kann, ist zunächst der count() des Arrays zu prüfen oder sicherzustellen, dass key() nichtnullist, nachdem reset() aufgerufen wurde.
Siehe auch
- current() - Liefert das aktuelle Element eines Arrays
- each() - Liefert das aktuelle Schlüssel-Wert-Paar eines Arrays und rückt den Arrayzeiger vor
- end() - Positioniert den internen Zeiger eines Arrays auf dessen letztes Element
- next() - Rückt den internen Arrayzeiger vor
- prev() - Setzt den internen Arrayzeiger um ein Element zurück
- array_key_first() - Gets the first key of an array
