SetVar(handle, string, value)

grandMA3 ユーザマニュアル » プラグイン » Lua 関数 - Object-Free API » SetVar(handle, string, value) Version 2.2

説明

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

If the variable exists, then the value is overwritten. If it does not exist, then it is created with value.

引数

  • handle:
    The handle of variable set.
  • string:
    The name of the variable. It needs to be in quotation marks.
  • value:
    The value can be a string, integer, or double.

戻り値

  • boolean:
    • True / 1: The variable was set.
    • False / 0: The variable was not set.

This example sets a value to the variable called "myUserVar" in the set of user variables if it exists.

Lua
return function()
-- Sets the value of user variable "myUserVar" to "Hello World" and store the returned boolean in a Lua variable
local success = SetVar(UserVars(), "myUserVar", "Hello World")
-- Prints the ressult
if success then
Printf("Variable is stored.")
else
Printf("Variable is NOT stored!")
end
end