current

Liefert das aktuelle Element eines Arrays

Beschreibung

mixed current ( array &$array )

Jedes Array hat einen internen Zeiger auf sein "aktuelles" Element, welcher auf das erste in das Array eingefügte Element initialisiert wird.

Parameter-Liste

array: Das Array.

Rückgabewerte

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.

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 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) { }
?>

Anmerkungen

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.

Siehe auch

end
key
each
prev
reset
next