json.path.set: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
m (Conversion script moved page Json.path.set to json.path.set: Converting page titles to lowercase)
No edit summary
Line 6: Line 6:


|usage=
|usage=
<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
json.path.set(json, path, value)
json.path.set(json, path, value)
</source>
</syntaxhighlight>


'''Parameters'''
'''Parameters'''
Line 18: Line 18:
|examples=
|examples=
Suppose we have the following nested json:
Suppose we have the following nested json:
<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
[h:troll = json.set("{}", "name", "Troll", "HP", 75, "Attacks", json.append("Claw", "Bite"))]
[h:troll = json.set("{}", "name", "Troll", "HP", 75, "Attacks", json.append("Claw", "Bite"))]
[h:orc = json.set("{}", "name", "Orc", "HP", 13, "Attacks", json.append("Sword", "Punch"))]
[h:orc = json.set("{}", "name", "Orc", "HP", 13, "Attacks", json.append("Sword", "Punch"))]
[h:monsters = json.set("{}", "Troll", troll, "Orc", orc)]
[h:monsters = json.set("{}", "Troll", troll, "Orc", orc)]
</source>
</syntaxhighlight>


To replace the Punch to an Axe, we can run
To replace the Punch to an Axe, we can run


<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
[monsters = json.path.set(monsters, "Orc.Attacks.[1]", "Axe")]
[monsters = json.path.set(monsters, "Orc.Attacks.[1]", "Axe")]
</source>
</syntaxhighlight>


To change all "Sword" attacks to "Greatsword", we can run
To change all "Sword" attacks to "Greatsword", we can run


<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
[monsters = json.path.set(monsters, "*.Attacks[?(@ == 'Sword')]", "Great Sword")]
[monsters = json.path.set(monsters, "*.Attacks[?(@ == 'Sword')]", "Great Sword")]
</source>
</syntaxhighlight>


}}
}}

Revision as of 16:39, 15 March 2023

json.path.set() Function

Introduced in version 1.5.5
Change an element in a nested JSON Array. Additional information on how to specify the path is available here.

Usage

json.path.set(json, path, value)

Parameters

  • json - The json element in which the JSON Array is nested.
  • path - The path to the element in the JSON Array.
  • value - The value to change.

Examples

Suppose we have the following nested json:
[h:troll = json.set("{}", "name", "Troll", "HP", 75, "Attacks", json.append("Claw", "Bite"))]
[h:orc = json.set("{}", "name", "Orc", "HP", 13, "Attacks", json.append("Sword", "Punch"))]
[h:monsters = json.set("{}", "Troll", troll, "Orc", orc)]

To replace the Punch to an Axe, we can run

[monsters = json.path.set(monsters, "Orc.Attacks.[1]", "Axe")]

To change all "Sword" attacks to "Greatsword", we can run

[monsters = json.path.set(monsters, "*.Attacks[?(@ == 'Sword')]", "Great Sword")]