CXI-Basis-Programmierreferenz / Version 2 / Datenspeicherung / CxiNode / Sonstige Variablentypen /
CxiHandle CxiNode :: GetArc (CxiName pname, CxiHandle spb) const
CxiHandle cxiGetArc (CxiHandle self, CxiName pname, CxiHandle spb)
Liest einen geschachtelten CXI-Knoten.
pname:
Name der Variablen
spb:
Handle eines Blocks, in dem die gelesenen Daten abgelegt werden, spb darf NICHT gleich this bzw. self sein. Anstelle eines CxiHandle kann auch ein CxiNode-Objekt angegeben werden.
return:
bei Erfolg spb (Inhalt von spb wird vollständig ersetzt),
bei Fehler NULL (Inhalt von spb bleibt unverändert)
Resource-Referenzen werden aufgelöst. Ist dies nicht möglich, wird ein Fehler zurückgegeben.
Portabilität:
Diese Funktion ist in allen unterstützten Systemen verfügbar. Ab Version 2.05 wird der Fall spb==this bzw. spb==self als Fehler erkannt und führt zur Rückgabe von NULL; ältere Versionen führten die Operation auch in diesem Fall - nicht immer fehlerfrei - durch.
Siehe auch:
SetArc - Archivblock setzen