each

(PHP 3, PHP 4 )

each -- 配列から、次のキーと値のペアを返す

説明

array each ( array array)

配列 array から、次のキーと値のペアを返し、 配列カーソルを進めます。このペアは、4つの要素を持つ配列で、 それぞれの要素は 0 , 1 , key , value というキーを有 しています。要素 0 key の各々は配列要素のキー名称を保持しており、 1 value の各々はそのデータを保持しています。

配列の内部ポインタが、配列の最終要素以降を指す場合、 each() FALSE を返します。

例 1 each() の例

$foo = array ("bob", "fred", "jussi", "jouni", "egon", "marliese");
$bar = each ($foo);

$bar は、ここでは以下のキー/値のペアを保持し ています。

  • 0 = 0
  • 1 = 'bob'
  • key = 0
  • value = 'bob'
$foo = array ("Robert" =  "Bob", "Seppo" =  "Sepi");
$bar = each ($foo);


$bar は、この時点で以下のキー/値のペアを保持 しています。

  • 0 = 'Robert'
  • 1 = 'Bob'
  • key = 'Robert'
  • value = 'Bob'




通常 each() は、配列の走査をす?_っk list() と共に使用されます。例えば、 $HTTP_POST_VARSの場合は次のようになります。

例 2 each() により$HTTP_POST_VARSを走査する

echo "POSTメソッドにより受け渡された値: br ";
reset ($HTTP_POST_VARS);
while (list ($key, $val) = each ($HTTP_POST_VARS)) {
   echo "$key =  $val br ";
}


each() を実行した後、配列カーソルは、 配列の次の要素に移動します。配列の最終要素にカーソルがある場合は、 最終要素にとどまります。eachを使用して配列を走査するには、 reset() を使用する必要があります。

key() list() current() reset() next() prev() も参照下さい。