CXI-Basis-Programmierreferenz / Version 2 / Tools / Definitionen und Makros /

cxin - Makro für Variablennummern

CxiName cxin (unsigned int i)

Variablennummer (cxin ist als Makro implementiert)

i:
Variablennummer im Bereich cxiMinVarNumb (=1) bis cxiMaxVarNumb (=65535)

Um auf Variablen mit einer Nummer statt mit einem Namen zugreifen zu können, muss ein Name in der Form "#nnnnn" angegeben werden. Eine gleichwertige optimierte Alternative ist die Verwendung von cxin(i), dieser Aufruf liefert ein CxiName-Objekt, das zum Zugriff auf die Variable mit der Nummer i verwendet werden kann. An allen Stellen des CXI-Systems, wo ein Parameter vom Typ CxiName erwartet wird, kann - sofern VariablenNUMMERN nicht ausdrücklich ausgeschlossen werden - auch cxin(i) eingesetzt werden.

Es wird KEIN GÜLTIGER ZEIGER zurückgegeben, sondern ein interner Schlüssel zum Zugriff auf die Variable. Der zurückgegebene CxiName-Wert darf daher NICHT DEREFERENZIERT werden, sondern ausschließlich als Parameter vom Typ CxiName an CXI-Funktionen weitergegeben werden.

Es gilt cxin(0) == NULL, dies ist nützlich, um Fallunterscheidungen zu vermeiden. Wird bei 32-Bit-Systemen für den Parameter i ein Wert größer als 65535 angegeben, so werden nur die niederwertigen 16 Bit berücksichtigt, da cxin den Parameter zunächst nach unsigned short konvertiert.

Kann cxin unter einem gegebenen System nicht direkt als Makro implementiert werden (z.B. Netware), wird es durch eine Klasse (C++) oder einen Funktionsaufruf (C) emuliert. Unter DOS, Windows und OS/2 steht cxin uneingeschränkt als Makro zur Verfügung.