CXI-Basis-Programmierreferenz / Version 2 / Datenspeicherung / CxiNode / Numerische Variablen /
CxiError CxiNode :: SetByt (CxiName pname, CxiByte pval)
CxiError cxiSetByt ...P (CxiHandle self, CxiName pname, CxiByte pval)
pname:
Name der Variablen oder Pfadangabe und Variablenname
pval:
Wert der Variablen (0 bis 255)
return:
0 ok, sonst Fehler
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 SetByt statt wie bisher SetChr (siehe Hinweis oben). Der alte Name SetChr für diese Funktion kann weiterhin benutzt werden.
Siehe auch:
GetByt