4D Doc Center : DOM Append XML child node

4D v13.4

DOM Append XML child node


DOM Append XML child node ( elementRef ; childType ; childValue ) -> 戻り値

引数	型	説明
elementRef	テキスト	XML要素参照
childType	倍長整数	追加する子のタイプ
childValue	テキスト, BLOB	子ノードとして挿入するテキストまたは (テキストあるいはBlob) 変数
戻り値	テキスト	子XML要素参照

説明

DOM Append XML child node コマンドを使用して、elementRefで指定したXMLノードにchildValueの値を追加できます。

作成されるノードのタイプをchildTypeで指定します。この引数には""テーマの以下の定数を渡すことができます:

定数	型	値
XML CDATA	倍長整数	7
XML Comment	倍長整数	2
XML DATA	倍長整数	6
XML DOCTYPE	倍長整数	10
XML ELEMENT	倍長整数	11
XML Processing Instruction	倍長整数	3

childValueには挿入するデータを渡します。文字列または4D変数 (文字またはBLOB) を渡します。この引数の内容は常にテキストに変換されます。

Note: elementRef がドキュメントノード (トップレベルノード) を指す場合、コマンドは他のノードの前に"Doctype"ノードを挿入します。同じことが処理命令やコメントにも言えます。これらは常にルートノードの前 (かつDoctypeノードの後) に挿入されます。

例題 1

テキストタイプのノードを追加します:

 Reference:=DOM Create XML element(elementRef;"myElement")

 DOM SET XML ELEMENT VALUE(Reference;"Hello")

 temp:=DOM Create XML element(Reference;"br")

 temp:=DOM Append XML child node(Reference;XML DATA;"New")

 temp:=DOM Create XML element(Reference;"br")

 temp:=DOM Append XML child node(Reference;XML DATA;"York")

結果:

<myElement>Hello<br/>New<br/>York</myElement>

例題 2

処理命令タイプのノードを追加します:

 $Txt_instruction:="xml-stylesheet type = \"text/xsl\" href=\"style.xsl\""

 Reference:=DOM Append XML child node(elementRef;XML Processing Instruction;$Txt_instruction)

結果 (最初の要素の前に挿入される):

<?xml-stylesheet type="text/xsl"  href="style.xsl"?>

例題 3

コメントタイプのノードを追加する:

Reference:=DOM Append XML child node(elementRef;XML Comment;"Hello world")

結果:

<!--Hello  world-->

例題 4

CDATAタイプのノードを追加する:

Reference:=DOM Append XML child node(elementRef;XML CDATA;"12 < 18")

結果:

<element><![CDATA[12  < 18]]></element>

例題 5

Doctype 線減退のノードを追加あるいは置き換える:

Reference:=DOM Append XML child node(elementRef;XML DOCTYPE;"Books SYSTEM \"Book.DTD\"")

結果 (最初の要素の前に挿入される):

<!DOCTYPE  Books SYSTEM  "Book.DTD">

例題 6

要素タイプのノードを追加あるいは置き換える。

childValue 引数がXMLフラグメントの場合、子ノードとして挿入されます:
Reference:=DOM Append XML child node(elementRef;XML ELEMENT;"<child>simon</child><child>eva</child>")

結果:
```
<parent>
     <child>simon</child>
    <child>eva</child>
</parent>
```
それ以外の場合、新しい空の子要素が追加されます:
Reference:=DOM Append XML child node(elementRef;XML ELEMENT;"break")

Result:
```
<parent>
     <break/>
 </parent>
```

childValue の内容が有効でない場合、エラーが返されます。