end

配列の内部ポインタを最終要素にセットする

説明

mixed end(arrayobject &$array)

endarray の内部ポインタを最後の要素まで進め、その値を返します。

パラメータ

array

配列。この配列は参照渡しとなります。関数内で配列の中身を変更するからです。 つまり、ここには配列そのものを渡さなければならず、 配列を返す関数を指定することはできません。 参照渡しできるのは、実際の変数だけだからです。

戻り値

最後の要素の値、あるいは空の配列の場合は false を返します。

変更履歴

バージョン 説明
8.1.0 この関数を object に対してコールすることは、推奨されなくなりました。 object に対して最初に get_mangled_object_vars を使って配列に変換するか、ArrayIterator のような Iterator を実装したクラスのメソッドを使ってください。
7.4.0 SPL クラスのインスタンスは、プロパティを持たない空のオブジェクトのように扱われるようになりました。これより前のバージョンでは、この関数と同じ名前の Iterator のメソッドをコールしていました。

例1 end の例

<?php

$fruits = array('リンゴ', 'バナナ', 'クランベリー');
echo end($fruits); // クランベリー

?>

参考

  • current
  • each
  • prev
  • reset
  • next
  • array_key_last