DOMDocument::getElementById

(No version information available, might be only in CVS)

DOMDocument::getElementById — id に対応する要素を検索する

説明

DOMElement DOMDocument::getElementById ( string $elementId )

この関数は、 DOMDocument::getElementsByTagName と同じですが、指定した ID から要素を検索する点が違います。

この関数を動作させるには、何らかの ID 属性を DOMElement::setIdAttribute で設定するか、あるいは DTD で ID 型の属性を定義する必要があります。後者の場合は、 DOMDocument::validate あるいは DOMDocument->validateOnParse を使用してドキュメントを検証する必要があります。

パラメータ

elementId: 要素の ID。

返り値

DOMElement、あるいは要素が見つからなかった場合は NULL を返します。

例

例1 DOMDocument->getElementById() の例


<?php

$doc = new DomDocument;

// ID を参照する前に、ドキュメントを検証する必要があります
$doc->validateOnParse = true;
$doc->Load('book.xml');

echo "ID が books の要素は " . $doc->getElementById('books')->tagName . " です。\n";

?>

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

ID が books の要素は chapter です。

参考

DOMDocument::getElementsByTagName