Du bist hier: Tips » Scripte » PHP
PHP
Referenzliste

each

Array-Funktionen

    Befehl:
array each ( array &$array )


    Parameter-Liste:
NameBeschreibung
arrayDas Eingabe-Array.

    Rückgabewerte:
Gibt das aktuelle Schlüssel-Wert-Paar aus dem Array array zurück. Dieses Paar wird als Array mit vier Elementen zurückgegeben, und zwar mit den Schlüsseln 0, 1, key, und value. Die Elemente 0 und key enthalten den Namen des Schlüssels, 1 und value den Wert.

Zeigt der interne Zeiger hinter das Ende der Array-Inhalte, gibt each() FALSE zurück.

    Beschreibung:
Die Funktion each() gibt bei einem assoziativen Array das Schlüssel-/Wertepaar des aktuellen Elements zurück. Es wird ein Array mit 4 Elementen erzeugt, wobei jeweils zwei Elemente denselben Wert haben.

Der Schlüssel steht in den Elementen mit dem Index 0 und dem Index key zur Verfügung, der Wert in den Elementen mit dem Index 1 und dem Index value. Das untere Beispiel gibt das Schlüssel-/Wertepaar des ersten Elements aus.


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

    Achtung:
Achtung:

Da die Zuweisung eines Arrays zu einer anderen Variable den originalen Arrayzeiger zurücksetzt, würde unser obiges Beispiel in eine Endlosschleife geraten, hätten wir $fruit innerhalb der Schleife einer anderen Variable zugeordnet.


    Warnung:
Warnung:

each() akzeptiert ebenfalls Objekte, liefert aber eventuell unerwartete Ergebnisse zurück. Es wird daher nicht empfohlen, über Objekteigenschaften mit each() zu iterieren.


    Siehe auch:
•  key()
Liefert einen Schlüssel eines assoziativen Arrays
 
•  list()
Weist Variablen zu, als wären sie ein Array
 
Liefert das aktuelle Element eines Arrays
 
•  reset()
Setzt den internen Zeiger eines Arrays auf sein erstes Element
 
•  next()
Rückt den internen Zeiger eines Arrays vor
 
•  prev()
Setzt den internen Zeiger eines Arrays um ein Element zurück
 

each() - Beispiele:


Eingabe:
<?php
$foo = array("bob", "fred", "jussi", "jouni", "egon", "marliese");
$bar = each($foo);
print_r($bar);
?>


Ausgabe:
Array
(
    [1] => bob
    [value] => bob
    [0] => 0
    [key] => 0
)
each() - Beispiele 2:


Eingabe:
<?php
$foo = array("Robert" => "Bob", "Seppo" => "Sepi");
$bar = each($foo);
print_r($bar);
?>


Ausgabe:
Array
(
    [1] => Bob
    [value] => Bob
    [0] => Robert
    [key] => Robert
)
each() - Beispiele 3: Durchgehen eines Arrays mit each()


Eingabe:
<?php
$fruit = array('a' => 'Apfel', 'b' => 'Banane', 'c' => 'Preiselbeere');

reset($fruit);
while (list($key, $val) = each($fruit)) {
    echo "$key => $val\n";
}
?>


Ausgabe:
a => Apfel
b => Banane
c => Preiselbeere
Array-Funktionen