[Overview][Constants][Types][Classes][Procedures and functions][Variables][Index] Reference for unit 'System' (#rtl)

Inc

Increase value of integer variable

Declaration

Source position: system.fpd line 50

procedure Inc(

  var X: TOrdinal

);

procedure Inc(

  var X: TOrdinal;

  Increment: TOrdinal

);

Description

Inc increases the value of X with Increment. If Increment isn't specified, then 1 is taken as a default.

Inc can be used on typed pointers: in that case it increases the value with Increment the size of the type the pointer points to. This works independently of the setting of the $POINTERMATH directive.

Errors

If range checking is on, then A range check can occur, or an overflow error, when an attempt is made to increase X over its maximum value.

See also

Dec

  

Decrease value of variable

Example

Program Example32;

{ Program to demonstrate the Inc function. }

Const
  C : Cardinal  = 1;
  L : Longint   = 1;
  I : Integer   = 1;
  W : Word      = 1;
  B : Byte      = 1;
  SI : ShortInt = 1;
  CH : Char     = 'A';

begin
  Inc (C);     { C:=2    }
  Inc (L,5);   { L:=6    }
  Inc (I,-3);  { I:=-2   }
  Inc (W,3);   { W:=4    }
  Inc (B,100); { B:=101  }
  Inc (SI,-3); { Si:=-2  }
  Inc (CH,1);  { ch:='B' }
end.


Documentation generated on: Jun 23 2021