(PHP 3, PHP 4)
配列 array から、次のキーと値のペアを返し、 配列カーソルを進めます。このペアは、4つの要素を持つ配列で、 それぞれの要素は 0, 1, key, value というキーを有 しています。要素 0 と key の各々は配列要素のキー名称を保持しており、 1 と value の各々はそのデータを保持しています。
配列の内部ポインタが、配列の最終要素以降を指す場合、 each() は FALSE を返します。
例 1 each() の例
$bar は、ここでは以下のキー/値のペアを保持し ています。
$bar は、この時点で以下のキー/値のペアを保持 しています。
通常 each() は、配列の走査をす?_っk list() と共に使用されます。例えば、 $HTTP_POST_VARSの場合は次のようになります。
例 2 each() により$HTTP_POST_VARSを走査する
each() を実行した後、配列カーソルは、 配列の次の要素に移動します。配列の最終要素にカーソルがある場合は、 最終要素にとどまります。eachを使用して配列を走査するには、 reset() を使用する必要があります。
key() 、 list() 、 current() 、 reset() 、 next() 、 prev() も参照下さい。