(PHP 4, PHP 5, PHP 7, PHP 8)
reset — 配列の内部ポインタを先頭の要素にセットする
array
入力の配列。
配列の最初の要素の値を返します。 配列が空の場合 false
を返します。
バージョン | 説明 |
---|---|
8.1.0 | この関数を object に対してコールすることは、推奨されなくなりました。 object に対して最初に get_mangled_object_vars() を使って配列に変換するか、ArrayIterator のような Iterator を実装したクラスのメソッドを使ってください。 |
7.4.0 | SPL クラスのインスタンスは、プロパティを持たない空のオブジェクトのように扱われるようになりました。これより前のバージョンでは、この関数と同じ名前の Iterator のメソッドをコールしていました。 |
例1 reset() の例
<?php
$array = array('step one', 'step two', 'step three', 'step four');
// デフォルトでは、ポインタは先頭要素を指しています
echo current($array) . "<br />\n"; // "step one"
// 次の2ステップをとばします
next($array);
next($array);
echo current($array) . "<br />\n"; // "step three"
// ポインタをリセットし、再度ステップ1開始します
reset($array);
echo current($array) . "<br />\n"; // "step one"
?>