next

(PHP 4, PHP 5, PHP 7)

nextRückt den internen Zeiger eines Arrays vor

Beschreibung

next ( array &$array ) : mixed

next() verhält sich ähnlich wie current(), mit einem Unterschied. Der interne Zeiger wird um ein Element vorgerückt, bevor der Wert des Elements zurückgegeben wird, d.h. es wird der Wert des nächsten Elements zurückgegeben, und der interne Zeiger um eins erhöht.

Parameter-Liste

array

Das zu beeinflussende array.

Rückgabewerte

Gibt den Wert des nächsten Elements des Arrays zurück, auf das der interne Zeiger des Arrays gerade zeigt. Sind keine Elemente mehr vorhanden, wird FALSE zurückgegeben.

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 Beispiel für die Verwendung von next() und anderen

<?php
$transport 
= array('zu Fuß''Fahrrad''Auto''Flugzeug');
$mode current($transport); // $mode = 'zu Fuß';
$mode next($transport);    // $mode = 'Fahrrad';
$mode next($transport);    // $mode = 'Auto';
$mode prev($transport);    // $mode = 'Fahrrad';
$mode end($transport);     // $mode = 'Flugzeug';
?>

Anmerkungen

Hinweis: Das Ende eines Arrays ist von einem boolean FALSE Element nicht zu unterscheiden. Um ein Array, das möglicherweise FALSE Elemente enthält, ordnungsgemäß zu durchlaufen, kann foreach() verwendet werden. Um dennoch next() verwenden zu können, und ordnungsgemäß zu prüfen, ob das Ende des Arrays erreicht wurde, sollte geprüft werden, ob der key() NULL ist.

Siehe auch

  • current() - Liefert das aktuelle Element eines Arrays
  • end() - Positioniert den internen Zeiger eines Arrays auf dessen letztes Element
  • prev() - Setzt den internen Zeiger eines Arrays um ein Element zurück
  • reset() - Setzt den internen Zeiger eines Arrays auf sein erstes Element
  • each() - Liefert das aktuelle Paar (Schlüssel und Wert) eines Arrays und rückt den Arrayzeiger vor