@XMLNodeListRelease

Diese @Function gibt ein zuvor erzeugtes VSPECHXMLNODELIST (XMLNL) Handle wieder frei.
Die Funktion gibt den internen Speicher frei, der für die im NodeList-Handle enthaltenen XML-Knotenreferenzen verwendet wird.
Nach erfolgreicher Ausführung darf das übergebene XML-NodeList-Handle nicht mehr mit anderen NodeList-Funktionen verwendet werden.

VSPECHXMLNODELIST XMLNL:
Handle der freizugebenden XML-NodeList.
XMLNL muss ein gültiges VSPECHXMLNODELIST (XMLNL) Handle enthalten, das auf eine zuvor erzeugte XML-NodeList verweist.

Return-Wert:
Bei erfolgreicher Ausführung liefert die @Function TRUE.
Ist das übergebene XML-NodeList-Handle ungültig oder bereits freigegeben, liefert die @Function @ERROR.

Beispiel: @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);

Das Beispiel erzeugt eine XML-NodeList mit allen "<customer>"-Elementen und gibt die NodeList anschließend wieder frei.