current

(PHP 3, PHP 4, PHP 5)

current -- 配列内のカレントの要素を返す

説明

mixed current ( array &array )

各配列は、"カレント"の要素へのポインタを有しています。 このポインタは、その配列の最初の要素を指すように初期化されます。

current()関数は、単に内部ポインタが現在 指している配列要素の値を返します。この関数は、ポインタを全く移動 しません。内部ポインタが最終要素の次を指していた場合、 current()FALSEを返します。

警告

配列中に空の要素(0または空の文字列"")がある場合、この関数はこれ らの要素についてFALSEを返します。現在の要素が値0または配列の終 わりを通過したのかを決定することができないのです。配列を正しく 順番に処理するには、each()を使用してください。

例 1. current() と類似関数の使用例

<?php
$transport
= array('foot', 'bike', 'car', 'plane');
$mode = current($transport); // $mode = 'foot';
$mode = next($transport);    // $mode = 'bike';
$mode = current($transport); // $mode = 'bike';
$mode = prev($transport);    // $mode = 'foot';
$mode = end($transport);     // $mode = 'plane';
$mode = current($transport); // $mode = 'plane';
?>

end(), key(), next(), prev(), reset()も 参照ください。