(PHP 3, PHP 4 )
each --
配列から、次のキーと値のペアを返す
説明
array
each ( array array)
配列arrayから、次のキーと値のペアを返し、
配列カーソルを進めます。このペアは、4つの要素を持つ配列で、
それぞれの要素は0,1,
key,valueというキーを有
しています。要素 0とkey
の各々は配列要素のキー名称を保持しており、1
とvalueの各々はそのデータを保持しています。
配列の内部ポインタが、配列の最終要素以降を指す場合、
each()はFALSEを返します。
例 1each()の例 $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()も参照下さい。