json.append: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
 
(6 intermediate revisions by 3 users not shown)
Line 1: Line 1:
==Function json.append==
{{MacroFunction
|name=json.append
|version=1.3b49
|description=
Appends values to the end of a [[JSON Array]]. An empty string ("") can be used to represent an empty [[JSON Array]] to append the values to.


 
|usage=
 
<syntaxhighlight lang="mtmacro" line>
'''Introduced in MapTool 1.3b49'''
Appends values to the end of a [[Macros:json array|json array]]. An empty string ("") can be used to represent an empty [[Macros:json array|json array]] to append the values to.
 
===Usage===
<source lang="mtmacro" line>
[h: jarr = json.append(jarr, value, ...)]
[h: jarr = json.append(jarr, value, ...)]
</source>
</syntaxhighlight>


|example=
Create a JSON array from a string list and then append an additional value.
<syntaxhighlight lang="mtmacro" line>
[h:a=json.fromList("a,1,g,4")]
[r: json.append(a, 55)]
</syntaxhighlight>
Returns
<syntaxhighlight lang="javascript">
["a",1,"g",4,55]
</syntaxhighlight>


===Examples===
Create a JSON array directly with append.
<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
  [h:a=json.fromList("a,1,g,4")][r: json.append(a, 55)]
[r: json.append("", 1, 5, 8, 33)]
  [r: json.append("", 1, 5, 8, 33)]
</syntaxhighlight>
</source>


Returns
Returns
  ["a",1,"g",4,55]
<syntaxhighlight lang="javascript">
  [1,5,8,33]
[1,5,8,33]
</syntaxhighlight>
 
}}
[[Category:JSON Function]]

Latest revision as of 18:43, 15 March 2023

json.append() Function

Introduced in version 1.3b49
Appends values to the end of a JSON Array. An empty string ("") can be used to represent an empty JSON Array to append the values to.

Usage

[h: jarr = json.append(jarr, value, ...)]

Example

Create a JSON array from a string list and then append an additional value.
[h:a=json.fromList("a,1,g,4")]
[r: json.append(a, 55)]

Returns

["a",1,"g",4,55]

Create a JSON array directly with append.

[r: json.append("", 1, 5, 8, 33)]

Returns

[1,5,8,33]