Reference Guide > X–Z Routines > XmlFreeDoc Function
  

XmlFreeDoc Function
Frees memory for XML documents in memory (DOM representation).
Usage
status = XmlFreeDoc(document_id)
Input Parameters
document_id—The document to free and release memory for.
Returned Value
status—A value of 1 is returned if the operation was successful.
Discussion
This routine is used to reclaim memory for documents parsed using XmlParse, or created from scratch using XmlNewDoc. Typically this is called after a document has been queried with XmlEvaluate and is not needed anymore, or if the document has been exported using XmlDocDump and the DOM representation in memory is no longer needed. Be careful to only call this routine once for a given document ID or a segmentation fault could result.
Example 1
This example removes a DOM model from memory.
; Parse and evaluate a document
doc_id = XmlParse('chart.xml', /file)
table = XmlEvaluate(doc_id, '//*')
; Free the document
status = XmlFreeDoc(doc_id)

Version 2017.0
Copyright © 2017, Rogue Wave Software, Inc. All Rights Reserved.