INCR statement

Purpose | Increment a variable by 1; increment a pointer by the size of its target; or increment the target of a numeric pointer by 1.
Syntax | INCR variable

Remarks

variable can be a pointer or a pointer variable. When INCR is used with a numeric variable, 1 is added to the numeric variable.

When INCR is used with a pointer variable itself, the value of the pointer is incremented by the size of the pointer's target.

When INCR is used on a numeric pointer's target (i.e., INCR @IntPtr) the value of the target is incremented by 1.

For example, given a pointer to an array where the pointer targets element 1000, applying INCR to the pointer would result in the pointer aiming at element 1001. The actual address held by the pointer would have risen by two, because the target of the pointer is an Integer which is two bytes wide.

Conversely, if INCR was used on the target of this Integer pointer, the value of the element itself would be incremented by 1.

See also | DECR, LET
Example | DIM x&, LongPtr AS LONG POINTER INCR x& INCR LongPtr INCR @LongPtr