DOM Find XML element

4D v20 R7


DOM Find XML element ( elementRef ; xPath {; arrElementRefs} ) -> 戻り値

引数	型	説明
elementRef	文字	XML要素参照
xPath	テキスト	検索する要素のXPathパス
arrElementRefs	文字配列	見つかった要素参照のリスト (該当する場合)
戻り値	文字	見つかった要素の参照 (該当する場合)

説明

DOM Find XML element コマンドはXMLストラクチャ中で特定のXML要素を検索するために使用します。検索はelementRef 引数で指定された要素から開始されます。

探すXMLノードはXPath記法を使用して xPath 引数に指定します (詳細な情報については、XPath記法のサポート (DOM) の章を参照してください)。以下のパス式がサポートされます:

式	アクション
nodename	コンテキストノードの子で、"nodename" という名前を持つ要素すべてを選択します。
/	パスがツリーのルート(根)から始まることを示します。(絶対パス)
//	パスがツリーのカレントノードから始まり、中間の要素数は問わないことを示します。
@	属性を選択します
.	カレントノードを選択します
..	カレントノードの親を選択します
*	コンテキストノードの子要素を選択します
@*	コンテキストノードの属性を全て選択します
text()	コンテキストノードのテキストノードを連結して選択します
node()	コンテキストノードの子に相当するすべてのノードを選択します
local-name()	コンテキストノードのローカル名を返します。ノードセットに対して使用した場合、1番目のノードのローカル名を返します
para[1]	コンテキストノードの子で、"para" という名前を持つ最初の要素を選択します
para[last()]	コンテキストノードの子で、"para" という名前を持つ最後の要素を選択します
chapter[title="Introduction"]	コンテキストノードの子で、"chapter" という要素名であり、"title" という子がIntroduction という文字列値である要素を選択します
chapter[title]	コンテキストノードの子で、"chapter"という要素名であり、"title"という子を持つ要素を選択します
para[@type="warning"]	コンテキストノードの子で、"para" という名前を持ち、"type" 属性が"warning" という値である全ての要素を選択します
para[@type="warning"][5]	コンテキストノードの子で、"para" という名前を持ち、"type" 属性が"warning" という値である5つ目の要素を選択します
para[5][@type="warning"]	コンテキストノードの子で"para" という名前を持つ5番目の要素の"type" 属性が"warming" という値であれば選択します
para[contains(@type,'bg')]	コンテキストノードの子で"para" という名前を持ち、"type"属性が"bg"という文字列を含んでいる全ての要素を選択します
//title \| //price	ドキュメント内の全てのtitle要素とprice要素を選択します

互換性に関する注意: v18 R3 以降、4D のXPath 実装はより幅広い式に対応しサポートするために変更されました。互換性上の理由から、以前の標準でない実装は返還されたデータベースではデフォルトでは維持されます。変換されたデータベースにおいて拡張された機能を利用するためには、互換性ページの互換性オプションの標準XPath を使用するオプションを選択してください。

注: 検索は全て小文字と大文字を区別します。

このコマンドは見つかった要素のXML 参照を返します。arrElementRefs 文字列配列が渡されると、コマンドはこの配列に見つけた要素のリストを返します。この場合コマンドは結果としてarrElementRefs 配列の最初の要素を返します。この引数はxPath 引数で指定した場所に同じ名前の要素が複数ある場合に利用できます。

例題 1

以下のXML 構造がある場合を考えます:

<?xml version="1.0" encoding="UTF-8" standalone="no" ?>
<bookstore>
<book>
  <title lang="en">Harry Potter</title>
  <price>29.99</price>
</book>
<book>
  <title lang="en">Learning XML</title>
  <price>39.95</price>
</book>
</bookstore>

以下のコードを実行すると、XML 要素を素早く検索し、その値を表示させることができます:

 vElemRef:=DOM Parse XML source("books.xml")

 vFound:=DOM Find XML element(vElemRef;"book[2]/title") // カレントノードからの相対パス

 DOM GET XML ELEMENT VALUE(vFound;value)

 ALERT("要素の値は: \""+value+"\"") // Learning XML が表示される

同じ検索は、以下のコードを使用しても実行できます:

 vElemRef:=DOM Parse XML source("books.xml")

 vFound:=DOM Find XML element(vElemRef;"/bookstore/book[2]") // rootからの絶対パス

 vFound:=DOM Find XML element(vFound;"title")

 DOM GET XML ELEMENT VALUE(vFound;value)

 ALERT("要素の値は: \""+value+"\"") // Learning XML が表示される

例題 2

以下のXML構造があるとき:

<?xml version="1.0" encoding="UTF-8" standalone="no" ?>
<Root>
   <Elem1>
      <Elem2>aaa</Elem2>
      <Elem2>bbb</Elem2>
      <Elem2>ccc</Elem2>
   </Elem1>
</Root>

以下のコード使用して、それぞれのElem2 要素の参照をarrAfound 配列に取得することができます:

 vElemRef:=DOM Parse XML source("example.xml")

 ARRAY TEXT(arrAfound;0)

 vFound:=DOM Find XML element(vElemRef;"/Root/Elem1/Elem2";arrAfound)

要素参照が無効の場合。
指定されたXPathパスが無効の場合。

参照

DOM Count XML elements
DOM Create XML element