XmlFreeNode Function
Removes and frees memory for nodes and sub-nodes.
Usage
status = XmlFreeNode(node_id)
Input Parameters
node_id—The node ID that is used to free and release memory.
Returned Value
status—A value of 1 is returned if the operation was successful.
Discussion
This routine is used to remove a node and all sub-nodes in a node tree. It is usually used with the node ids returned by XmlEvaluate, but can also be used with the node ID returned from XmlNewNode. Be careful to only call this routine once for a given node ID and to not try and access the node or sub-nodes after removing them or a segmentation fault could result.
Example 1
This example removes a sub tree from a DOM.
; Parses an XML document and show all nodes.
doc_id = XmlParse('chart.xml', /File)
table = XmlEvaluate(doc_id, '//*')
; Removes part of the node tree
FOR i=0L, N_ELEMENTS(table)-1 DO PRINT, table(i)
status = XmlFreeNode(table(5).nodeid)
table = XmlEvaluate (doc_id, '//*')
; Gets a new copy of the node tree and display it
XmlDocDump, doc_id, xml, Format=2
PRINT, xml