System.Inc

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

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

Propriétés

Type Visibilité  Source Unité  Parent
procedure public System.pas System System


Description

Incrémente une valeur ordinale de 1 ou de N.

Dans le code Delphi, la procédure Inc ajoute 1 ou N à la variable X.

X est une variable de type ordinal (incluant Int64) ou de type pointeur si la syntaxe étendue est activée.

N est une expression entière.

X s'incrémente d'une unité ou de N si N a été spécifié, par exemple :

  • Inc(X) équivaut à l'instruction X := X + 1
  • Inc(X, N) équivaut à l'instruction X := X + N.

Sur certaines plates-formes Inc génère un code optimisé, particulièrement utile dans les boucles à exécution intensive.

Si X est de type pointeur, il incrémente X de N fois la taille du type sur lequel il pointe. Donc, soit :

 type
   PMyType = ^TMyType;

et

 var
   P: PMyType;

L'instruction Inc(P) incrémente P de SizeOf(TMyType).

Avertissement: Vous ne pouvez pas utiliser Inc sur des propriétés, car elle modifie le paramètre.
Remarque: Inc(S, I), où S est un ShortInt et I un nombre supérieur à 127, provoque le déclenchement d'une exception EIntOverFlow si les vérifications de dépassement et d'étendue sont activées. Sous Delphi 1.0, aucune exception n'était déclenchée.

Voir aussi

Exemples de code