Forum und email

next

(PHP 4, PHP 5, PECL axis2:0.1.0-0.1.1 xmlreader:1.0-1.0.1)

next — Rückt den internen Zeiger eines Arrays vor

Beschreibung

mixed next ( array &$array )

Diese Funktion 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, wie zum Beispiel0 oder "". der von einem einfachen if-Statement als FALSE ausgewertet wird. Weitere Informationen entnehmen Sie bitte dem Abschnitt über die Boolsche Typen. Benutzen Sie deshalb den === Operator um den Rückgabewert dieser Funktion zu überprüfen.

Hinweis: Es ist nicht möglich, das Ende eines Arrays von einem boolean FALSE-Wert zu unterscheiden. Um ein Array, das FALSE-Elemente beinhalten könnte, korrekt zu durchlaufen werfen Sie bitte einen Blick auf die each()- Funktion.

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. Zeigt der interne Zeiger hinter das Ende der Elementliste, wird FALSE zurückgegeben.

Example#1 Beispiel für die Verwendung von next() und anderen

<?php
$transport 
= array('zu Fußfoot''Fahhrad''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';
?>

Siehe auch current(), end(), prev(), reset() und each().