4D Doc Center : SAX GET XML ELEMENT

4D v14.3

SAX GET XML ELEMENT


SAX GET XML ELEMENT ( document ; name ; prefix ; attrNames ; attrValues )

引数	型	説明
document	DocRef	開いたドキュメントの参照
name	文字	要素名
prefix	文字	名前空間
attrNames	文字配列	属性名
attrValues	文字配列	属性値

説明

SAX GET XML ELEMENT コマンドはdocument 引数で参照されるXMLドキュメントに現れる、name要素についてのさまざまな情報を返します。このコマンドはXML Start ElementまたはXML End Element SAXイベントで呼び出さなければなりません。XML End Elementの特定のケースでは、属性引数は処理されません。SAXイベントに関する詳細はSAX Get XML node コマンドの説明を参照してください。

name 引数には要素名を渡します。

prefix 引数には要素の名前空間が返されます。要素に名前空間がリンクされていない場合は空の文字列となります。

attrNames 配列にはターゲット要素の属性名リストが返されます。必要に応じてコマンドは配列を作成しサイズを調整します。

attrValues 配列にはターゲット要素の属性値が返されます。必要に応じてコマンドは配列を作成しサイズを調整します。

例題

以下のXMLコードがあります:

<RootElement>
   <Child Att1="111" Att2="222" Att3="333">MyText</Child>
</RootElement>

以下のコードが実行されると:

SAX GET XML ELEMENT(DocRef;vName;vPrefix;tAttrNames;tAttrValues)

vNameには"Child"が、
vPrefixには""が、
tAttrNames{1} には "Att1"、
tAttrNames{2} には "Att2"、
tAttrNames{3} には "Att3"が
tAttrValues{1} には "111",
tAttrValues{2} には "222"、
tAttrValues{3} には "333"が返されます。

システム変数およびセット

コマンドが正しく実行されるとシステム変数OKに1が設定され、そうでなければ0が設定されてエラーが生成されます。