json.fields: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
(Reordering and rewriting toward a more standard presentation)
No edit summary
 
(4 intermediate revisions by 3 users not shown)
Line 8: Line 8:


|usage=
|usage=
<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
json.fields(jobj)
json.fields(jobj)
</source>
</syntaxhighlight>
<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
json.fields(jobj, delim)
json.fields(jobj, delim)
</source>
</syntaxhighlight>


'''Parameters'''
'''Parameters'''
Line 22: Line 22:


|example=
|example=
<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
[h: a=json.fromStrProp("a=1;b=44;c=12")]
[h: a=json.fromStrProp("a=1;b=44;c=12")]
[r: json.fields(a)]
[r: json.fields(a)]
</source>
</syntaxhighlight>
Returns
Returns
   b,c,a
   a,b,c


<source lang="mtmacro" line>
 
<syntaxhighlight lang="mtmacro" line>
[h: a=json.fromList("a,1,g,4")]
[h: a=json.fromList("a,1,g,4")]
[r: json.fields(a,";")]
[r: json.fields(a,";")]
</source>
</syntaxhighlight>
Returns
Returns
   0;1;2;3
   0;1;2;3


<source lang="mtmacro" line>
 
<syntaxhighlight lang="mtmacro" line>
[h: a=json.fromStrProp("a=1;b=44;c=12")]
[h: a=json.fromStrProp("a=1;b=44;c=12")]
[r: json.fields(a, "json")]
[r: json.fields(a, "json")]
</source>
</syntaxhighlight>
Returns
Returns
   ["a","c","b"]
   ["a","b","c"]
}}
}}
[[Category:JSON Function]]
[[Category:JSON Function]]

Latest revision as of 17:49, 15 March 2023

json.fields() Function

Introduced in version 1.3b49
Returns the fields (keys) for a JSON Object or the indexes for a JSON Array as a string list. The type of the value returned depends on the delimiter parameter. Note: Because JSON Objects are unordered, json.fields will not reflect the order they were set in.

Usage

json.fields(jobj)
json.fields(jobj, delim)

Parameters

  • delim =
    • unspecified: a standard string list is returned, with its default "," delimiter.
    • "json": a JSON Array is returned.
    • "x": a string list is returned with "x" used as a delimiter.

Example

[h: a=json.fromStrProp("a=1;b=44;c=12")]
[r: json.fields(a)]

Returns

 a,b,c


[h: a=json.fromList("a,1,g,4")]
[r: json.fields(a,";")]

Returns

 0;1;2;3


[h: a=json.fromStrProp("a=1;b=44;c=12")]
[r: json.fields(a, "json")]

Returns

["a","b","c"]