reset

(PHP 4, PHP 5)

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

Beschreibung

mixed reset ( array &$array )

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.

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"

?>

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