Tinderbox v10 Icon

JSON.json[itemNum]


Operator Type: 

Operator Scope of Action: 

Operator Purpose: 

Data Type Returned: 

Operator First Added: 

Operator in Current Baseline: 

Operator Last Altered: 

 Function  [other Function type actions]

 Item  [operators of similar scope]

 Stream parsing  [other Stream parsing operators]

 source context dependent

 v9.5.0

 Baseline

 As at baseline


JSON.json[itemNum]

If there is no current JSON object, attempts to parse the string as JSON and fails if unsuccessful. If there is a current JSON object, that object will be reused. See JSON.json[keyStr], for more information as to when String.captureJson() might need to be used before applying this operator.

If the top-level element is an array, JSON.json[N] returns the itemNum object. Note that [ ] square brackets, not ( ) parentheses must be used to pass N. If the top-level element is an object, see JSON.json[keyStr].

For example, if the $Text is:

{ [1,4,9,16,25] } 

Then $Text.json[1] is 4.

This usage follows the existing list[N] convention.


See also—notes linking to here: