CXI-Basis-Programmierreferenz / Version 2 / Datenspeicherung / CxiNode / Typübergreifende Funktionen /

UpdateNumber - Variablen umnummerieren

CxiError CxiNode :: UpdateNumber (CxiName pvon, CxiName pbis, signed short pdiff)
CxiError cxiUpdateNumber (CxiHandle self, CxiName pvon, CxiName pbis, signed short pdiff)

Ändert Variablennummern

pvon:
Anfang des Nummernbereichs in der Form cxin(1) oder "#00001"

pbis:
Ende des Nummernbereichs in der Form cxin(9) oder "#00009"

pdiff:
Zu addierender Wert (positiv oder negativ) oder 0

return:
0 ok, sonst Fehler

Alle Variablen mit Nummern größer oder gleich pvon und kleiner oder gleich pbis erhalten eine um pdiff geänderte Nummer. Variablen, die dadurch den Bereich pvon bis pbis verlassen, werden gelöscht. Ist pdiff == 0, so werden alle Variablen mit Nummern im angegebenen Bereich gelöscht.

Für die Spezialfälle pdiff == -1 und pdiff == +1 stehen eigene Funktionen zur Verfügung.

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

Siehe auch:
InsertNumber
DeleteNumber