current
(PHP 4, PHP 5, PHP 7)
current — 配列内の現在の要素を返す
説明
current
( array|object $array
) : mixed
各配列は、"カレント"の要素へのポインタを有しています。 このポインタは、配列に挿入された最初の要素を指すように初期化されます。
パラメータ
array
- 配列。
返り値
current() 関数は、
単に内部ポインタが現在指している配列要素の値を返します。
この関数は、ポインタを全く移動しません。
内部ポインタが最終要素の次を指していたり
配列が空だったりした場合、
current() は false
を返します。
変更履歴
バージョン | 説明 |
---|---|
7.0.0 | array は常に値で渡されるようになりました。
このバージョンより前は、可能な場合は参照で、それ以外の場合は値で 渡されていました。 |
例
例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) { }?>
注意
注意:
配列の最終要素の次を指していた場合や、 空の配列に対して、current() を呼び出した時の結果は、 bool
false
要素を指していた場合と区別できません。false
要素を含む配列を順に処理するには、foreach() 関数を参照ください。 それでも current() を使い、 値が本当に配列の要素であることを適切にチェックするには、 current() が指す要素の key() の値が、 厳密にnull
ではないことをチェックすべきです。