set: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
mNo edit summary
(added params, trusted and version info.)
Line 1: Line 1:
{{MacroFunction
{{MacroFunction
|name=set
|name=set
|trusted=false
|version=1.3b48
|description=
|description=
Sets the value of a variable.
Sets the value of a variable.
Line 10: Line 12:
[h: set(varName, val)]
[h: set(varName, val)]
</source>
</source>
'''Parameters'''
{{param|varName|Variable name or a string containing a valid variable name.}}
{{param|val|The value to set the variable to.}}


|example=
|example=

Revision as of 11:52, 5 July 2019

set() Function

Introduced in version 1.3b48
Sets the value of a variable.

This function is rarely used because a simple assignment to a variable name can be used instead. However, using this function allows the first parameter to be a variable that identifies the variable name to be assigned.

Usage

[h: set(varName, val)]

Parameters

  • varName - Variable name or a string containing a valid variable name.
  • val - The value to set the variable to.

Example

A simple use:
[h: set("test", 33)]
[r: test]

Returns

   33

A more sophisticated example that shows passing a string expression as the first parameter:

[h: var1="te"]
[h: var2="st"]
[h: set(var1+var2, 33)]
[r: test]

Returns

   33

Both of the above examples are equivalent to:

[r: test = 33]