json.path.add

From RPTools Wiki
Revision as of 17:36, 15 March 2023 by Taustin (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

json.path.add() Function

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

Usage

json.path.add(json, path, value)

Parameters

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

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 add a new attack to our Orc, such as a "Bow" attack, we could type

[monsters = json.path.add(monsters, "Orc.Attacks", "Bow")]