@XMLNodeListRelease

This @Function releases a previously created VSPECHXMLNODELIST (XMLNL) handle.
The function releases the internal memory used for the XML node references stored in the node list handle.
After successful execution, the supplied XML node list handle must no longer be used with other node list functions.

VSPECHXMLNODELIST XMLNL:
Handle of the XML node list to be released.
XMLNL must contain a valid VSPECHXMLNODELIST (XMLNL) handle that references a previously created XML node list.

Return Value:
On successful execution, the @Function returns TRUE.
If the supplied XML node list handle is invalid or has already been released, the @Function returns @ERROR.

Example: @XMLNodeListRelease(XMLNL);

XML := "<?xml version=\"1.0\" encoding=\"UTF-8\"?>" +
"<customers>" +
" <customer id=\"1\" />" +
" <customer id=\"2\" />" +
"</customers>";
hXMLD := @XMLParse(XML);
hXMLRoot := @XMLGetRoot(hXMLD);
hXMLNL := @XMLSelectNodes(hXMLRoot;"customer");
@XMLNodeListRelease(hXMLNL);
@XMLRelease(hXMLD);

The example creates an XML node list containing all "<customer>" elements and then releases the node list.

Note : This text was machine-translated and may contain inaccuracies.