CXI-Basis-Programmierreferenz / Version 2 / Datenspeicherung / CxiNode / Konstruktoren, Destruktor, Operatoren /

DeleteCxiNode, DeleteCxiTree - Löschen eines CXI-Objekts

CxiError cxiDeleteCxiNode (CxiHandle self)
CxiError cxiDeleteCxiTree (CxiHandle self)

Löscht ein CXI-Knoten- oder CXI-Baum-Objekt und gibt den Speicherbereich frei

Die beiden Namen cxiDeleteCxiNode und cxiDeleteCxiTree sind Synonyme für die gleiche Funktion, das CXI-System entscheidet intern, ob self ein CxiNode- oder CxiTree-Handle ist.

Die Funktion gibt allen benutzten Speicher frei, das übergebene CxiHandle ist anschließend ungültig. Mehrfacher Aufruf von cxiDeleteCxiNode für das gleiche Objekt kann NICHT abgefangen werden und führt zur Zerstörung des Heaps.

Diese Funktion gilt für alle Handles (CxiNode oder CxiTree), die mit den folgenden Funktionen erstellt wurden:

cxiCreateCxiNodeStandard - Standardblock
cxiCreateCxiNode - Allgemeiner CXI-Knoten
cxiCreateCxiNodeCopy - Kopie eines CXI-Knotens
cxiCreateCxiTree - CXI-Baum über Initialisierungsblock
cxiCreateCxiTreeTemp - Temporärer CXI-Baum
cxiCreateCxiTreeMem - CXI-Baum im Hauptspeicher
cxiCreateCxiTreeFile - CXI-Baum in Datei
cxiCreateCxiTreeSubst - Teilbaum eines CXI-Baums
cxiCreateCxiTreeSubstRO - Geschützter Teilbaum eines CXI-Baums

Portabilität:
Diese Funktion ist in allen unterstützten Systemen verfügbar.

Siehe auch:
~CxiNode() - Destruktor
InvalidateObject - Freigabe eines CXI-Knotens