grandMA3 User Manual Publication

GetVar(handle, string)

grandMA3 User Manual » Plugins » Lua Functions - Object-Free API » GetVar(handle, string)
Version 2.1

Description

The GetVar Lua function returns the value of a specific variable in a set of variables. To learn more about the variables in plugins, look at the Variable Functions topic.

Arguments

  • Handle:
    The handle of variable set.
  • String:
    The name of the variable. It needs to be in quotation marks.

Return

  • Value:
    This is the value of the variable.

If the variable does not exist, then nil is returned.

Example

This example returns the value of a variable called "myUserVar" in the set of user variables if it exists:

Lua
return function()
-- Get the value from a user variable called "myUserVar" - assuming it already exists
local varValue = GetVar(UserVars(), "myUserVar")
-- Print en error feedback or the value of the variable
if varValue == nil then
Printf("Variable returns nothing!")
else
Printf("Variable value is: " .. varValue)
end
end