PHP each() 関数

PHP 配列関数

例

現在の要素のキー名とキー値を返し、内部ポインタを前に進めます：

<?php
$people = array("Bill", "Steve", "Mark", "David");
print_r (each($people));
?>

実行例

定義と用法

each() 関数は、現在の要素のキー名とキー値を返し、内部ポインタを前に進めます。

この要素のキー名とキー値は、4つの要素を持つ配列に返されます。2つの要素（1 と Value）がキー値を含み、2つの要素（0 と Key）がキー名を含みます。

関連するメソッド：

  • current() - 配列の現在の要素の値を返します
  • end() - 内部ポインタを配列の最後の要素に指し、出力します
  • next() - 内部ポインタを配列の次の要素に指し、出力します
  • prev() - 内部ポインタを配列の前の要素に指し、出力します
  • reset() - 内部ポインタを配列の最初の要素に指し、出力します

文法

each(array)
パラメータ 説明
array 必須。使用する配列を指定します。

説明

each() 関数は、配列の現在の内部ポインタが指している要素のキー名とキー値からなる配列を生成し、内部ポインタを前に進めます。

返される配列には以下の4つの要素が含まれます：キー名が 0、1、key、value。ユニット 0 と key には配列ユニットのキー名が含まれ、1 と value にはデータが含まれます。

内部ポインタが配列の範囲を越えた場合、この関数は FALSE を返します。

技術的詳細

返り値：

現在の要素のキー名とキー値を返します。キー名とキー値は、4つの要素を持つ配列に返されます。

2つの要素（1 と Value）がキー値を含み、2つの要素（0 と Key）がキー名を含みます。

配列の要素がなくなった場合、関数は FALSE を返します。
PHP バージョン： 4+

さらに例

例 1

ページの上部のインスタンスと同じですが、この例では配列全体を出力するためにループを使用しています：

<?php
$people = array("Bill", "Steve", "Mark", "David");
reset($people);
while (list($key, $val) = each($people))
  {
  echo "$key => $val<br>";
  }
?>

実行例

例 2

すべての関連するメソッドを示します：

<?php
$people = array("Bill", "Steve", "Mark", "David");
echo current($people) . "<br>"; // 現在の要素は Bill
echo next($people) . "<br>"; // Bill の次の要素は Steve
echo current($people) . "<br>"; // 現在の現在の要素は Steve
echo prev($people) . "<br>"; // Steve の前の要素は Bill
echo end($people) . "<br>"; // 最後の要素は David
echo prev($people) . "<br>"; // David の前にある要素は Mark
echo current($people) . "<br>"; // 現在の現在の要素は Mark
echo reset($people) . "<br>"; // 内部ポインタを配列の最初の要素に移動します、即ち Bill
echo next($people) . "<br>"; // Bill の次の要素は Steve
print_r (each($people); // 現在の要素のキー名とキー値（現在は Steve）を返し、内部ポインタを前に進める
?>

実行例

PHP 配列関数