eachBir diziden, gösterici konumundaki anahtar değer çiftini
döndürdükten sonra göstericiyi bir ilerletir
&reftitle.description;
arrayeacharrayobjectdizi
Belirtilen diziden, gösterici konumundaki anahtar değer çiftini
döndürür ve göstericiyi sonraki öğeye ilerletir.
each işini bitirdikten sonra dizi göstericisi bir
sonraki elemana konumlanır; eğer gösterici zaten sonuncu elemandaysa
gösterici sonuncudan sonraki olmayan elemana konumlanır. Dizi baştan
taranmak istenirse gösterici reset ile dizinin
başlangıcına taşınmalıdır.
&reftitle.parameters;
dizi
Üzerinde işlem yapılacak dizi.
&reftitle.returnvalues;
dizi dizisinin göstericisinin üzerinde bulunduğu
anahtar değer çifti ile döner. Bu çift dört elemanlı, 0,
1, key ve value
anahtarlarına sahip bir dizi olarak döner. 0 ve
key elemanları anahtarı, 1 ve
value ise değeri içerir.
Eğer gösterici sonuncu dizi elemanının sonrasındaysa
each işlevi &false; döndürür.
&reftitle.examples;
- each örnekleri
]]>
$bar şu anahtar değer çiftlerini içerir:
bob
[value] => bob
[0] => 0
[key] => 0
)
]]>
"Bob", "Seppo" => "Sepi");
$bar = each($foo);
print_r($bar);
?>
]]>
$bar şu anahtar değer çiftlerini içerir:
Bob
[value] => Bob
[0] => Robert
[key] => Robert
)
]]>
each genellikle bir diziyi taramak için
list işleviyle birlikte kullanılır. Örnek:
- each ile bir dizinin taranması
'apple', 'b' => 'banana', 'c' => 'cranberry');
reset($fruit);
while (list($key, $val) = each($fruit)) {
echo "$key => $val\n";
}
?>
]]>
&example.outputs;
apple
b => banana
c => cranberry
]]>
Bir dizinin bir değişkene atanması özgün dizi göstericisini
sıfırladığından yukarıdaki örnekte $fruit dizisini
döngü içinde başka bir değişkene atamak sonsuz bir döngüye sebep olurdu.
each işlevi nesne de kabul eder fakat beklenmedik
sonuçlar verebilir. Bu bakımdan nesne öğelerinin each
ile taranması önerilmez.
&reftitle.seealso;
keylistcurrentresetnextprev&foreach;Nesne
Yineleme