(PHP 4, PHP 5, PHP 7)
current — Liefert das aktuelle Element eines Arrays
Jedes Array hat einen internen Zeiger auf sein "aktuelles" Element, welcher auf das erste in das Array eingefügte Element initialisiert wird.
arrayDas Array.
Die Funktion current() liefert den Wert des Array
Elements, auf das gerade vom internen Zeiger gezeigt wird. Sie
bewegt den Zeiger in keiner Weise. Zeigt der interne Zeiger
hinter das Ende der Elementenliste, gibt
current() FALSE zurück.
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.
| Version | Beschreibung |
|---|---|
| 7.0.0 |
array wird nun immer als Wert übergeben.
Vor dieser Version wurde es, wenn möglich, als Referenz übergeben, und
andernfalls als Wert.
|
Beispiel #1 Beispiel für die Verwendung von current() 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';
$arr = array();
var_dump(current($arr)); // bool(false)
$arr = array(array());
var_dump(current($arr)); // array(0) { }
?>
Hinweis: Das Ende eines Arrays und das Ergebnis des Aufrufs von current() mit einem leeren Array sind nicht unterscheidbar von einem boolean
FALSEElement. Um ein Array, dasFALSEElemente enthalten kann, korrekt zu Durchlaufen, siehe die Funktion foreach(). Um dennoch current() zu verwenden, und korrekt zu prüfen, ob der Wert tatsächlich ein Element des Arrays ist, sollte überprüft werden, ob der key() des current() Elements sich strikt vonNULLunterscheidet.