NsisXML plug-in (by Wizou)
From NSIS Wiki
|Author: Wizou (talk, contrib)|
nsisXML -- Small NSIS plugin to manipulate XML data through MSXML written by Olivier Marcoux
The following is taken from the readme file in the downloadable zip file:
You can typically use it to: - create, read, modify, write XML files - create, remove, search XML nodes - set/get nodes content or attributes Usage ----- nsisXML::create creates an empty XML document in memory and returns its reference in $0 and $1 nsisXML::load <filename> load given XML file into document $0 REQUIRES that an XML document be already created in $0 (if XML document $0 is not empty, all content will be discarded) sets $0 to 0 if an error occurred nsisXML::loadAndValidate <filename> same as load but performs validation on the XML if a schema is present, and resolves external definitions (may try to establish an Internet connection) nsisXML::save <filename> saves current document $0 to given file nsisXML::createProcessingInstruction <target> <data> creates a new 'processing instruction' node and return its reference in $2 nsisXML::createElement <tag name> creates a new element node with given tag name (initially empty) and return its reference in $2 nsisXML::appendChild appends node $2 as a child of node $1 nsisXML::insertBefore insert node $2 as a child of node $1, to the left of node $3 ($3 must be a reference to a child node of $1) nsisXML::setAttribute <attribute name> <value> sets the given attribute with the given value on node $2 nsisXML::getAttribute <attribute name> returns in $3 the value for the given attribute name of node $2 if attribute is not found, returns an empty string nsisXML::setText <content text> sets the text content of the node $2 (<>the text between the tags</>) nsisXML::getText returns in $3 the text content for node $2 nsisXML::select <XPath expression> find the first node matching the given XPath expression on document in $0 and return its reference in $1 and $2 if not found, reference will be 0 nsisXML::parentNode returns in $1 the reference on the parent node of node $2 nsisXML::removeChild removes node $2 from the childs list of node $1 nsisXML::release <node reference> release immediately the memory associated with given node (typically $2, $1 or $0) for every nsisXML function that returns a node reference, you may want to release its memory after you're done working with the reference. however, please note that in any case, all memory used by MSXML will be released when your installer terminates. (so usually this is not a big concern)
2010-04-02: Added "release" to prevent memory leaks. Automatic use of most recent MSXML available. DLL is no longer unloaded after each call (you don't need /NOUNLOAD anymore)
2006-03-22: Added "insertBefore"
2006-03-13: Modified "load". Added "loadAndValidation"