setStrProp: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
m (Applied Template:MacroFunction)
No edit summary
 
(6 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{MacroFunction
{{MacroFunction
|name=setStrProp
|name=setStrProp
|version=1.3b42
|description=
|description=
Returns a [[Macros:string property list|string property list]] with the key set to the value passed in.  
Returns a [[String Property List]] with the key set to the value passed in.  


|usage=
|usage=
<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
[h: props = setStrProp(propList, key, value)]
setStrProp(propList, key, value)
</source>
</syntaxhighlight>
'''Parameters'''
{{param|propList|The [[String Property List]] affected by this function.}}
{{param|key|The key in the specified [[String Property List]] that will have its value set.}}
{{param|value|The value that the specified key will be set to.}}


|example=
|examples=
<source lang="mtmacro" line>
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)]
</source>
[r: weapon]
Returns "longsword".
</syntaxhighlight>
Returns {{code|"name{{=}}longsword ; damage{{=}}1d8 ; maxdamage{{=}}8 ; value{{=}}10 ; "}}
 
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 = setStrProp(weapon, "damage", "1d6")]
[r: weapon]
</syntaxhighlight>
Returns {{code|"name{{=}}longsword ; damage{{=}}1d6 ; maxdamage{{=}}8 ; "}}
 
|also=
{{func|getStrProp}}
}}
}}
[[Category:String Property List Function]]
[[Category:String Property List Function]]

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:
[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]
Returns "name=longsword ; damage=1d6 ; maxdamage=8 ; "

See Also