« SimpleXMLElement::count
SimpleXMLElement::getDocNamespaces »

SimpleXMLElement::current

(PHP 8)

SimpleXMLElement::current — 現在の要素を返す

説明

public function SimpleXMLElement::current(): SimpleXMLElement
警告

PHP 8.0 より前のバージョンでは、 SimpleXMLElement::current() はサブクラスの SimpleXMLIterator でのみ宣言されていました。

このメソッドは、現在の要素の SimpleXMLElement を返します。

パラメータ

この関数にはパラメータはありません。

戻り値

このメソッドは、現在の要素の SimpleXMLElement を返します。

エラー / 例外

失敗した場合は Error をスローします。

変更履歴

バージョン 説明
8.1.0 SimpleXMLElement::current() に不正なイテレータを渡してコールすると、 Error をスローするようになりました。 これより前のバージョンでは、null を返していました。

例

例1 現在の要素を返す

<?php
$xmlElement = new SimpleXMLElement('<books><book>PHP basics</book><book>XML basics</book></books>');

$xmlElement->rewind(); // 最初の要素に巻き戻します。こうしないと current() は動作しません。
var_dump($xmlElement->current());
?>

上の例の出力は以下となります。

object(SimpleXMLElement)#2 (1) {
  [0]=>
  string(10) "PHP basics"
}

参考

関連キーワード:
SimpleXMLElement   current   book   xmlElement   basics   books   rewind   最初   count   getDocNamespaces   サブクラス   SimpleXMLIterator   宣言   履歴   不正   イテレータ   スロー   dump   参考   キー   next   valid
関連する関数・ページ:
simplexmlelement.next   simplexmlelement.key   simplexmlelement.rewind   simplexmlelement.valid   simplexmliterator.haschildren   simplexmlelement.getchildren