current

(PHP 4, PHP 5)

current — 配列内の現在の要素を返す

説明

mixed current ( array &$array )

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

パラメータ

array: 配列。

返り値

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

警告

この関数は論理値 FALSE を返す可能性がありますが、FALSE として評価される値を返す可能性もあります。詳細については論理値のセクションを参照してください。この関数の返り値を調べるには ===演算子を使用してください。

例

例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';

$arr = array();
var_dump(current($arr)); // bool(false)

$arr = array(array());
var_dump(current($arr)); // array(0) { }
?>

注意

注意: 配列中に boolean FALSE の要素が含まれていると、それを配列の終わりと区別することができません。FALSE 要素を含む配列を順に処理するには、 each() 関数を参照ください。

参考

end() - 配列の内部ポインタを最終要素にセットする
key() - 配列からキーを取り出す
each() - 配列から現在のキーと値のペアを返して、カーソルを進める
prev() - 内部の配列ポインタをひとつ前に戻す
reset() - 配列の内部ポインタを先頭の要素にセットする
next() - 内部配列ポインタを進める