Du bist hier: Tips » Scripte » PHP
PHP
Referenzliste

current

Array-Funktionen

    Befehl:
mixed current ( array &$array )


    Parameter-Liste:
NameBeschreibung
arrayDas 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 keinster 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.

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


    Aktiv in Version:
(PHP 4, PHP 5, PHP 7)

    Hinweis:
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()
Positioniert den internen Zeiger eines Arrays auf dessen letztes Element
 
•  key()
Liefert einen Schlüssel eines assoziativen Arrays
 
•  each()
Liefert das aktuelle Paar (Schlüssel und Wert) eines Arrays und rückt den Arrayzeiger vor
 
•  prev()
Setzt den internen Zeiger eines Arrays um ein Element zurück
 
•  reset()
Setzt den internen Zeiger eines Arrays auf sein erstes Element
 
•  next()
Rückt den internen Zeiger eines Arrays vor
 

current() - Beispiel:


Eingabe:
<?php
$transport = array('zu Fuss', 'Fahrrad', 'Auto', 'Flugzeug');
$mode = current($transport); // $mode = 'zu Fuss';
$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) { }
?>

current() - Beispiel 2:


Eingabe:
<?PHP
$array = array ( 'PHP', 'ASP', 'Perl' );

for ( $x = 0; $x < 3; $x++ )
{
    echo current ( $array ) . "\n";
    next ( $array );
}
?>


Ausgabe:
PHP
ASP
Perl
Array-Funktionen