inc()

Increments the passed integer variable by one and returns the incremented value. Accordingly you may only pass script variables of type integer which are allowed to modified (i.e. they may not be declared as const).

Function Prototype

inc(??variable??)

Arguments

Argument Name Data Type Description
??variable?? Integer Variable The integer variable to be incremented by one.
[required]

Return Value

Description Data Type
Value of the passed variable after the incrementation. Integer Number
The return value of this function is an extension by NKSP to allow inline incrementation (like shown in the example below). However if you want to preserve compatibility with KSP then you should not rely on having a return value.

Examples

on init declare $i message("inc(" & $i & ") = " & inc($i)) message("inc(" & $i & ") = " & inc($i)) message("inc(" & $i & ") = " & inc($i)) message("dec(" & $i & ") = " & dec($i)) message("dec(" & $i & ") = " & dec($i)) message("dec(" & $i & ") = " & dec($i)) end on

See also

dec()

Availability

Since LinuxSampler 2.0.0.svn15.