set: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
No edit summary
 
(5 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{MacroFunction
{{MacroFunction
|name=set
|name=set
|description
|trusted=false
|version=1.3b48
|description=
Sets the value of a variable.
Sets the value of a variable.
 
<p>
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.
</p>
|usage=
|usage=
<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
[h: set(varName, val)]
[h: set(varName, val)]
</source>
</syntaxhighlight>
'''Parameters'''
{{param|varName|Variable name or a string containing a valid variable name.}}
{{param|val|The value to set the variable to.}}


|example=
|example=
<source lang="mtmacro" line>
A simple use:
    [h: set("test", 33)] [r:test]
<syntaxhighlight lang="mtmacro" line>
</source>
[h: set("test", 33)]
[r: test]
</syntaxhighlight>
Returns  
Returns  
     33
     33
A more sophisticated example that shows passing a string expression as the first parameter:
<syntaxhighlight  lang="mtmacro" line>
[h: var1="te"]
[h: var2="st"]
[h: set(var1+var2, 33)]
[r: test]
</syntaxhighlight>
Returns
    33
Both of the above examples are equivalent to:
<syntaxhighlight lang="mtmacro" line>
[r: test = 33]
</syntaxhighlight>
}}
}}
[[Category:Miscellaneous Function]]
[[Category:Miscellaneous Function]]

Latest revision as of 23:59, 14 March 2023

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]