CXI-Basis-Programmierreferenz / Version 2 / Datenspeicherung / CxiNode / Sonstige Variablentypen /

SetArc - Archivblock setzen

CxiError CxiNode :: SetArc (CxiName pname, CxiHandle spb)
CxiError cxiSetArc (CxiHandle self, CxiName pname, CxiHandle spb)

Nimmt einen kompletten CxiNode als eine Variable auf.

pname:
Name der Variablen

spb:
Aufzunehmender CXI-Knoten; Anstelle eines CxiHandle kann auch ein CxiNode-Objekt angegeben werden.

return:
0 ok, sonst Fehler

Mit dieser Funktion ist es möglich, CXI-Knoten direkt zu schachteln. Der Inhalt von spb wird vollständig in den eigenen Block kopiert.

Dieser Datentyp wird intern verwendet und kann bei EA-Zugriffen unter OS/2 nützlich sein. Für normale Anwendungen sollte die flexiblere Möglichkeit eines CXI-Baums eingesetzt werden. Ein Arc-Block ist KEIN UNTERBAUM!

Dies ist vergleichbar mit einem Archiv in einem Directory/Ordner. Ein Archiv (Arc-Block) kann mehrere Dateien (Variablen) enthalten. Auf die Dateien kann nur zugegriffen werden, wenn das Archiv vorher entpackt (GetArc) wird. Dennoch ist ein Archiv selbst eine Datei (Variable) und kein Directory (Unterbaum).

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

Siehe auch:
GetArc - Archivblock auslesen