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

ChangeNum - Numerische Variable ändern

CxiError CxiNode :: ChangeNum (CxiName pname, long int pval, const char *op = 0)
CxiError cxiChangeNum ...P (CxiHandle self, CxiName pname, long int pval, const char *op)

Ändert den Wert einer numerischen Variablen

pname:
Name der Variablen oder Pfadangabe und Variablenname

pval:
Zweiter Operand für Operation

op:
Durchzuführende Operation:
"=" oder NULL: Zuweisung von pval auf die Variable
"+": Addition von pval zum Wert der Variablen
"-": Subtraktion von pval vom Wert der Variablen
"*": Multiplikation des Werts der Variablen mit pval
"&": Bitweise UND-Verknüpfung des Werts der Variablen mit pval
"|": Bitweise ODER-Verknüpfung des Werts der Variablen mit pval

return:
0 ok, sonst Fehler

Operatorschreibweise:
Objekt [pname] = pval
Objekt [pname] += pval
Objekt [pname] -= pval
Objekt [pname] *= pval

Die Funktion ChangeNum ändert den Wert einer bestehenden numerischen Variablen, indem sie den Wert im Datenbereich des Blocks direkt ändert.

Existiert die Variable bereits, arbeitet die optimierte Funktion ChangeNum mit op=="=" schneller als SetNum. (Daher wird ChangeNum auch intern bei der CxiTree-Behandlung eingesetzt.)

Existiert die Variable noch nicht, wird sie mit dem Wert 0 neu erstellt, bevor die gewünschte Operation ausgeführt wird.

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

Siehe auch:
SetNum
GetNum
GetAsNum
GetAsStr