Function DE Version 10.01

@XMLRelease

XML

Syntax

@XMLRelease(XMLD);

Beschreibung

Diese @Function gibt ein zuvor erzeugtes VSPECHXMLDOC (XMLD) Handle wieder frei.

Die Funktion gibt alle Ressourcen, die mit dem VSPECHXMLDOC (XMLD) Handle verbunden sind wieder frei.
Nach erfolgreicher Ausführung darf das übergebene XML-Dokument-Handle nicht mehr mit anderen XML-Funktionen verwendet werden.
Dies gilt ebenfalls für Handles auf Elemente oder Knoten, die aus diesem XML-Dokument abgeleitet wurden.

VSPECHXMLDOC
XMLD:
Handle der freizugebenden XML-Dokumentenstruktur.
XMLD muss ein gültiges VSPECHXMLDOC (XMLD) Handle enthalten, das auf eine XML-Dokumentenstruktur verweist.

Als Return-Wert liefert die @Function bei einem Fehler @ERROR, andernfalls TRUE.


Beispiel: @XMLRelease(XMLD);

XML := "<?xml version=\"1.0\" encoding=\"UTF-8\"?>" +
"<customer>" +
" <name>Example GmbH</name>" +
" <city>Berlin</city>" +
"</customer>";

hXMLD := @XMLParse(XML);
hXMLRoot := @XMLGetRoot(hXMLD);
@XMLRelease(hXMLD);

Das Beispiel liest ein XML-Dokument ein, ermittelt dessen Root-Element "<customer>" und gibt die XML-Struktur anschließend wieder frei.