set: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
(New page: ==Function set== Sets the value of a variable. ===Usage=== <source lang="mtmacro" line> [h: set(varName, val)] </source> ===Examples=== <source lang="mtmacro" line> [h: set("test",...)
 
No edit summary
 
(6 intermediate revisions by 4 users not shown)
Line 1: Line 1:
==Function set==
{{MacroFunction
|name=set
|trusted=false
|version=1.3b48
|description=
Sets the value of a variable.
Sets the value of a variable.
 
<p>
===Usage===
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.
<source lang="mtmacro" line>
</p>
|usage=
<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=
A simple use:
<syntaxhighlight lang="mtmacro" line>
[h: set("test", 33)]
[r: test]
</syntaxhighlight>
Returns
    33


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

Latest revision as of 21:10, 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]