1mNAME0m
       incr - Increment the value of a variable

1mSYNOPSIS0m
       1mincr 4m22mvarName24m ?4mincrement24m?


1mDESCRIPTION0m
       Increments the value stored in the variable whose name is 4mvarName24m.  The
       value of the variable must be an integer.   If  4mincrement24m  is  supplied
       then  its  value  (which  must  be an integer) is added to the value of
       variable 4mvarName24m;  otherwise 1 is added to 4mvarName24m.  The new  value  is
       stored  as  a  decimal  string in variable 4mvarName24m and also returned as
       result.

1mEXAMPLES0m
       Add one to the contents of the variable 4mx24m:
              1mincr 22mx

       Add 42 to the contents of the variable 4mx24m:
              1mincr 22mx 42

       Add the contents of the variable 4my24m to the contents of the variable 4mx24m:
              1mincr 22mx $y

       Add nothing at all to the variable 4mx24m (often useful for checking whether
       an  argument to a procedure is actually numeric and generating an error
       if it is not):
              1mincr 22mx 0


1mSEE ALSO0m
       expr(n)


1mKEYWORDS0m
