reset

(PHP 4, PHP 5, PHP 7)

reset — Setzt den internen Zeiger eines Arrays auf sein erstes Element

Beschreibung

reset ( array &$array ) : mixed

reset() setzt den internen Zeiger von array auf das erste Element, und gibt den Wert des ersten Arrayelements oder FALSE, wenn das Array leer ist, zurück.

Parameter-Liste

array: Das Eingabearray.

Rückgabewerte

Gibt das erste Element des Arrays zurück oder FALSE wenn das Array leer ist.

Warnung

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.

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
reset($array);
echo current($array) . "<br />\n"; // "step one"

?>

Anmerkungen

Hinweis: Der Rückgabewert für ein leeres Array ist nicht vom Rückgabewert eines Arrays, das ein boolean FALSE als erstes Element hat, zu unterscheiden. Um den Wert des ersten Elements eines Arrays, das FALSE Elemente enthalten kann, ordnungsgemäß zu prüfen, ist zunächst der count() des Arrays, zu prüfen, oder dass key() nicht NULL ist, nachdem reset() aufgerufen wurde.

Siehe auch

current() - Liefert das aktuelle Element eines Arrays
each() - Liefert das aktuelle Paar (Schlüssel und Wert) eines Arrays und rückt den Arrayzeiger vor
end() - Positioniert den internen Zeiger eines Arrays auf dessen letztes Element
next() - Rückt den internen Zeiger eines Arrays vor
prev() - Setzt den internen Zeiger eines Arrays um ein Element zurück
array_key_first() - Gets the first key of an array