array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'de', ), 'this' => array ( 0 => 'function.current.php', 1 => 'current', 2 => 'Liefert das aktuelle Element eines Arrays', ), 'up' => array ( 0 => 'ref.array.php', 1 => 'Array Funktionen', ), 'prev' => array ( 0 => 'function.count.php', 1 => 'count', ), 'next' => array ( 0 => 'function.each.php', 1 => 'each', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'de', 'path' => 'reference/array/functions/current.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

current

(PHP 4, PHP 5, PHP 7, PHP 8)

current — Liefert das aktuelle Element eines Arrays

Beschreibung

current(array|object $array): mixed

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() gibt den Wert des Array-Elements zurück, auf das der interne Zeiger gerade zeigt. Sie bewegt den Zeiger überhaupt nicht. Zeigt der interne Zeiger hinter das Ende der Elementliste, 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.

Changelog

Version Beschreibung
8.1.0 Bei Objekten ist die Verwendung dieser Funktion veraltet. Stattdessen sollte entweder das Objekt vorher mit get_mangled_object_vars() in ein Array umgewandelt werden oder es sollten die Methoden einer Klasse verwendet werden, die Iterator implementiert, z. B. ArrayIterator.
7.4.0 Instanzen von SPL-Klassen werden nun wie leere Objekte behandelt, die keine Eigenschaften haben, anstatt die Iterator-Methode aufzurufen, die den gleichen Namen wie diese Funktion hat.

Beispiele

Beispiel #1 Beispiel für die Verwendung von current() und Freunden

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

$arr = array();
var_dump(current($arr)); // bool(false)

$arr = array(array());
var_dump(current($arr)); // array(0) { }
?>

Anmerkungen

Hinweis: Das Ergebnis des Aufrufs von current() auf ein leeres Array und auf ein Array, dessen interner Zeiger hinter das Ende der Elemente zeigt, sind nicht unterscheidbar von einem boolschen false-Element. Um ein Array, das möglicherweise false-Elemente enthält, korrekt zu durchlaufen, siehe die Kontrollstruktur foreach. Um current() dennoch zu verwenden und korrekt zu prüfen, ob der Wert tatsächlich ein Element des Arrays ist, sollte überprüft werden, ob sich der key() des current()-Elements im strikten Vergleich von null unterscheidet.

Siehe auch