setStrProp: Difference between revisions
Jump to navigation
Jump to search
Verisimilar (talk | contribs) m (Added params and see also, explained examples.) |
No edit summary |
||
| (2 intermediate revisions by one other user not shown) | |||
| Line 6: | Line 6: | ||
|usage= | |usage= | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
setStrProp(propList, key, value) | setStrProp(propList, key, value) | ||
</ | </syntaxhighlight> | ||
'''Parameters''' | '''Parameters''' | ||
{{param|propList|The [[String Property List]] affected by this function.}} | {{param|propList|The [[String Property List]] affected by this function.}} | ||
| Line 16: | Line 16: | ||
|examples= | |examples= | ||
Add a new key to an existing [[String Property List]]: | Add a new key to an existing [[String Property List]]: | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
[h: weapon = "name=longsword; damage=1d8; maxdamage=8"] | [h: weapon = "name=longsword; damage=1d8; maxdamage=8"] | ||
[h: weapon = setStrProp(weapon, "value", 10)] | [h: weapon = setStrProp(weapon, "value", 10)] | ||
[r: weapon] | [r: weapon] | ||
</ | </syntaxhighlight> | ||
Returns {{code|"name{{=}}longsword ; damage{{=}}1d8 ; maxdamage{{=}}8 ; value{{=}}10 ; "}} | Returns {{code|"name{{=}}longsword ; damage{{=}}1d8 ; maxdamage{{=}}8 ; value{{=}}10 ; "}} | ||
Change the value of a key in an existing [[String Property List]]: | Change the value of a key in an existing [[String Property List]]: | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
[h: weapon = "name=longsword; damage=1d8; maxdamage=8"] | [h: weapon = "name=longsword; damage=1d8; maxdamage=8"] | ||
[h: weapon = setStrProp(weapon, "damage", "1d6")] | [h: weapon = setStrProp(weapon, "damage", "1d6")] | ||
[r: weapon] | [r: weapon] | ||
</ | </syntaxhighlight> | ||
Returns {{code|"name{{=}}longsword ; damage{{=}}1d6 ; maxdamage{{=}}8 ; "}} | Returns {{code|"name{{=}}longsword ; damage{{=}}1d6 ; maxdamage{{=}}8 ; "}} | ||
Latest revision as of 20:33, 14 March 2023
setStrProp() Function
• Introduced in version 1.3b42
Returns a String Property List with the key set to the value passed in.
Usage
setStrProp(propList, key, value)Parameters
propList- The String Property List affected by this function.key- The key in the specified String Property List that will have its value set.value- The value that the specified key will be set to.
Examples
Add a new key to an existing String Property List:
Returns
[h: weapon = "name=longsword; damage=1d8; maxdamage=8"]
[h: weapon = setStrProp(weapon, "value", 10)]
[r: weapon]Returns "name=longsword ; damage=1d8 ; maxdamage=8 ; value=10 ; "
Change the value of a key in an existing String Property List:
[h: weapon = "name=longsword; damage=1d8; maxdamage=8"]
[h: weapon = setStrProp(weapon, "damage", "1d6")]
[r: weapon]"name=longsword ; damage=1d6 ; maxdamage=8 ; "