System.Inc

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

procedure Inc(var X: Integer); overload;
procedure Inc(var X: Integer; N: Integer); overload;

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
procedure public System.pas System System


Beschreibung

Inkrementiert einen Ordinalwert um 1 oder N.

In Delphi-Code fügt Inc der Variable X 1 oder N hinzu.

X ist eine Variable vom Typ Ordinal (einschließlich Int64) oder ein Zeigertyp, falls die erweiterte Syntax aktiviert ist.

N ist ein Integer-Ausdruck.

X inkrementiert um 1 oder um N, falls N angegeben ist. Zum Beispiel:

  • Inc(X) entspricht der Anweisung X := X + 1
  • Inc(X, N) entspricht der Anweisung X := X + N.

Auf einigen Plattformen kann Inc optimierten Code generieren, was besonders nützlich in engen Schleifen ist.

Wenn X ein Zeigertyp ist, wird X um N-mal der Größe des Typs, auf den gezeigt wird, inkrementiert. Bei:

 type
   PMyType = ^TMyType;

und

 var
   P: PMyType;

inkrementiert die Anweisung Inc(P) P um SizeOf(TMyType).

Warnung: Inc kann nicht für Eigenschaften verwendet werden, da sie den Parameter ändert.
Hinweis: Inc(S, I) führt bei aktivierter Bereichs- und Überlaufprüfung zu einer EIntOverFlow-Exception, wenn S den Datentyp ShortInt hat und I größer als 127 ist. In Delphi 1.0 hat diese Anweisung keine Exception ausgelöst.

Siehe auch

Codebeispiele