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

Data Type	Description
Integer Number	Value of the passed variable after the incrementation.

Remarks

This functions accepts any standard unit and finalness for its argument variable. The return value's standard unit and finalness is identical to the passed variable's one.

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

Availability

Since LinuxSampler 2.0.0.svn15.

Document Updated: 2019-09-16 | Author: Christian Schoenebeck