DOM Find XML element by ID
DOM Find XML element by ID ( elementRef ; id ) -> 戻り値
| 引数 | 型 | 説明 | |
|---|---|---|---|
| elementRef | Text | → | XML要素参照 |
| id | Text | → | 検索する要素のID属性値 |
| 戻り値 | Text | ← | 見つけた要素の参照 (該当する場合) |
説明
DOM Find XML element by ID コマンドはXMLドキュメント中で、id属性値が引数として渡したidと同じである要素を検索します。
elementRefにはXMLドキュメント中の要素の参照を渡します。ルート要素の参照あるいは他の要素の参照を渡すことができます。検索はelementRefの位置を考慮せず、常にドキュメント全体を検索します。
コマンドは見つけたXML要素の参照を返します。
警告: XMLにおいて、id属性はドキュメント要素ごとのユニークIDを関連付けます。ID属性の値は有効なXML名でなければならず、XMLドキュメント内のすべての要素中でユニークでなければなりません (妥当性制約)。DOM Find XML element by IDコマンドが正しく動作するためには、この制約が守られていなければなりません。そうでない場合、結果は保証されません (コマンドはドキュメント中で最初に見つけた要素を返します)。