json.fields: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
m (Correcting JSON Array link.)
Line 3: Line 3:
|version=1.3b49
|version=1.3b49
|description=
|description=
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.  
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.  
* If the delimiter is not specified then a [[Macros:string list|string list]] is returned with the default value of ',' is used.
* If the delimiter is not specified then a [[Macros:string list|string list]] is returned with the default value of ',' is used.
* If the delimiter ''"json"'' then a [[Macros:json array|json array]] is returned.
* If the delimiter ''"json"'' then a [[JSON Array]] is returned.
* Otherwise a [[Macros:string list|string list]] is returned with the delimiter passed in.
* Otherwise a [[Macros:string list|string list]] is returned with the delimiter passed in.



Revision as of 00:35, 5 April 2009

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.
  • If the delimiter is not specified then a string list is returned with the default value of ',' is used.
  • If the delimiter "json" then a JSON Array is returned.
  • Otherwise a string list is returned with the delimiter passed in.

Usage

[h: strList = json.fields(jobj)]
[h: strList = json.fields(jobj, delim)]
[h: jobj = json.fields(jobj, 'json')]

Example

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

Returns

 a,c,b
 0,1,2,3 
["a","c","b"]