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;"simoneva")
結果:
<parent>
<child>simon</child>
<child>eva</child>
</parent>
- それ以外の場合、新しい空の子要素が追加されます:
Reference:=DOM Append XML child node(elementRef;XML ELEMENT;"break")
Result:
<parent>
<break/>
</parent>
childValue の内容が有効でない場合、エラーが返されます。