current

(PHP 3, PHP 4, PHP 5)

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

説明

mixed current ( array &array )

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

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

警告

配列中に空の要素 (0 または空の文字列 "") がある場合、 これらの要素についてこの関数が返す値は FALSE と評価されます (詳細な情報は、boolean への変換 および 型変換の表 を参照ください)。 つまりこのような配列の場合は、current() を使用しても本当に配列の最後まで到達したのかどうかは判断できないのです。 配列を正しく順番に処理するには、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()も 参照ください。