CXI-Basis-Programmierreferenz / Version 2 / Datenspeicherung / CxiTree / Ableitung CxiTreeSubst /

CxiTreeSubstRO() - Geschützter Teilbaum eines CXI-Baums

CxiTreeSubstRO :: CxiTreeSubstRO (CxiTree& basis, CxiName pname = 0)
CxiHandle cxiCreateCxiTreeSubstRO (CxiHandle basis, CxiName pname)

Benutzt einen CXI-Teilbaum als eigenständigen Baum und schützt ihn gegen Veränderungen

basis:
CXI-Baum, dessen Teilbaum benutzt werden soll.

pname:
Bei NULL (Vorgabe) wird das aktuelle Sichtfenster von basis zur Wurzel des TreeSubst, sonst der durch pname angegebene Unterbaum des Sichtfensters.

return:
Die C-Funktion liefert das Handle des neuen CXI-Objekts, NULL im Fehlerfall

Die Klasse CxiTreeSubstRO verwaltet den angegebenen Teilbaum von basis als eigenen Baum. Dies entspricht etwa dem SUBST-Befehl des Dateisystems. Der als TreeSubst benutzte Teilbaum besitzt ein von basis unabhängiges eigenes Sichtfenster. Dieses Sichtfenster wird gegen Veränderungen geschützt, so dass der Baum basis nicht über das Subst-Objekt verändert werden kann. Der Zugriff auf basis direkt wird dadurch nicht verhindert.

CxiTreeSubstRO ist ein Spezialfall von CxiTreeSubst, die Hinweise und Anmerkungen dort sind unbedingt zu beachten.

Die Klasse CxiTreeSubst erbt InheritResource von CxiTreeSubst, die Baum-Funktionen von CxiTree, alle anderen Zugriffsfunktionen - auch den Destruktor - von CxiNode. Ob der Konstruktor erfolgreich war, kann anschließend durch einen Aufruf von Status() abgefragt werden.

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

Siehe auch:
Klassen CxiTreeSubst und CxiTreeSubstRO
InheritResource - Resourcezuordnungen erben
CxiTreeSubst() - {Konstruktor für ungeschützten Teilbaum}
DeleteCxiTree - Freigabe eines CxiHandle