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

GetCar - Characterarray auslesen

CxiError CxiNode :: GetCar (CxiName pname, void *pbuffer, CxiShort *psize) const
CxiError cxiGetCar ...P (CxiHandle self, CxiName pname, void *pbuffer, CxiShort *psize)

Liest eine beliebige Variable

pname:
Name der Variablen oder Pfadangabe und Variablenname

pbuffer:
Gelesener Wert der Variablen, Inhalt bei Fehler unverändert

psize:
IN: Länge des Puffers
OUT: Gelesene Länge

return:
0 ok, sonst Fehler

Resource-Referenzen werden aufgelöst. Ist dies nicht möglich, wird ein Fehler zurückgegeben.

Ist die geforderte Variable nicht vorhanden, so wird der Fehler cxiErrorVarNotFound zurückgeliefert und *psize auf 0 gesetzt.

Ist pbuffer == NULL oder der Bereich zu klein für den Wert der Variablen, so wird *psize auf die erforderliche Größe gesetzt und der Code cxiErrorBufferTooSmall zurückgeliefert.

Characterarrays (cxiTypeCar) werden bei Abspeicherung in Datei oder Übertragung innerhalb einer Message automatisch konvertiert, ansonsten sind sie identisch zu Binärvariablen.

Diese Funktion kann nur Variablen vom Typ cxiTypeCar auslesen.

Portabilität:
Diese Funktion und der Datentyp cxiTypeCar sind erst ab Version 2.09 20 definiert. Diese Funktion ist in allen unterstützten Systemen verfügbar.

Siehe auch:
SetCar
SetBin
GetBin