CXI-Basis-Programmierreferenz / Version 2 / Datenspeicherung / CxiNode / Numerische Variablen /

GetByt - Bytevariable auslesen

CxiByte CxiNode :: GetByt (CxiName pname, CxiByte pdef = 0) const
CxiByte cxiGetByt ...P (CxiHandle self, CxiName pname, CxiByte pdef)

Liest eine Bytevariable

pname:
Name der Variablen oder Pfadangabe und Variablenname

pdef:
Rückgabewert für den Fehlerfall (Vorgabe 0)

return:
Gelesener Wert der Variablen (0 bis 255), bei Fehler pdef

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

Bytevariablen werden immer als ein einzelnes Byte (unsigned char) abgelegt und besitzen daher die Datengröße 1.

Hinweis: Bytevariablen werden als numerische Werte (0 bis 255) aufgefasst und nicht als Zeichen, daher werden solche Variablen bei der Übertragung nicht konvertiert! Um einzelne Zeichen auf portable Weise in Datenbehältern abzulegen, sollte eine Zeichenkette der Länge 1 verwendet werden.

Portabilität:
Diese Funktion ist in allen unterstützten Systemen verfügbar. Bytevariablen werden erst ab Version 2.03 des CXI-Basissystems unterstützt und können von früheren Versionen nicht verarbeitet werden. Ab Version 2.07 heißt diese Funktion GetByt statt wie bisher GetChr (siehe Hinweis oben). Der alte Name GetChr für diese Funktion kann weiterhin benutzt werden.

Siehe auch:
SetByt
GetAsNum
GetAsStr