Skip to content

XML_ADDNODE系

関数名 引数 戻り値
XML_ADDNODE int, string, string(, int, int) int
ref string, string, string(, int, int) int
XML_ADDNODE_BYNAME string, string, string(, int, int) int

API

1. int XML_ADDNODE xmlId, xpath, nodeXml(, methodType, doSetAll)
2. int XML_ADDNODE ref xml, xpath, nodeXml(, methodType, doSetAll)
3. int XML_ADDNODE_BYNAME xmlName, xpath, nodeXml(, methodType, doSetAll)
指定したXMLに対して、xpathで選択した要素ノードをベースにノード追加をします(XPathについて)。
doSetAllが0または省略、かつ合致結果数が1以上である場合、追加は行われません。

  • methodTypeが0または省略した場合、選択した要素ノードを親ノードとし、その子ノードリストの最後にnodeXmlを子ノードとして追加します。
  • methodTypeが1の場合、選択した要素ノード（ルートノード以外）の前にnodeXmlを兄弟ノードとして追加します。
  • methodTypeが2の場合、選択した要素ノード（ルートノード以外）の後にnodeXmlを兄弟ノードとして追加します。

成功した場合、合致結果の数を返す。失敗した場合、0を返す。

  1. xmlIdを文字列に変換した結果(TOSTR)をキーとして、保存したXmlDocumentからノードを選択します。XmlDocumentが存在していない場合、-1を返します。
  2. xmlからノードを選択し、結果をxmlに代入します。xmlは変数でなければなりません。
  3. xmlNameをキーとして、保存したXmlDocumentからノードを選択します。XmlDocumentが存在していない場合、-1を返します。

注意

実際のXmlNodeインスタンスを得ることではないため、xpathの先頭に「//」の表現を使っても意味がありません。

ヒント

命令、式中関数両方対応しています。

例

MAIN.ERB
@SYSTEM_TITLE
    #DIMS xml = "<xml/>"

    PRINTFORML {XML_ADDNODE(xml, "/xml", "<child/>")} -> %xml%

    XML_DOCUMENT 0, xml

    PRINTFORML {XML_ADDNODE(0, "/xml/child", "<brother/>", 1)}
    PRINTSL XML_TOSTR(0)

    ONEINPUT
結果
1 -> <xml><child /></xml>
1
<xml><brother /><child /></xml>