^INCR

Increment an argument in a complex path

 

WNSupported in Synergy .NET on Windows

 

 

^INCR(variable[, post_flag])

Arguments

variable

The argument to increment.

post_flag

(optional) One of the following values:

true

Post‑increment. Increment occurs after the surrounding functionality takes place.

any other value

Pre‑increment. Increment occcurs before the surrounding functionality takes place. (default)

Discussion

If the data type for variable does not support increment operations, a “No operator” error (NOOPER) occurs.

Examples

In the example below, the result on the second writeline is 19, meaning the increment took place after the ToString().

main
record
    ivar, int
proc
    ivar = 18
    console.writeline(^incr(ivar).ToString())       ;Should be 19
    console.writeline(^incr(ivar,true).ToString())  ;Should be 19
    console.writeline(ivar)                         ;Should be 20