PHP マニュアル
前のページ次のページ

each

(PHP3 , PHP4 )

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()は、配列の走査をするために 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()を実行した後、配列カーソルは、 配列の次の要素に移動します。配列の最終要素にカーソルがある場合は、 最終要素にとどまります。

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

前のページHome次のページ
currentUpend