%JSON_ArrayGetArray function

Function

Returns an array on the specified index from a JSON array.

Declaration

INT %JSON_ArrayGetArray(
    INT in handle, 
    INT in index
 )

Parameters

handle	Handle to parent the JSON array.
index	Index of the array

Return value

Handle tot the JSON array, must be allowed by %JSON_FreeArrayHandle.

Description

The function returns an array on the specified index from the JSON array.

If the item type is not an array, the handle on the JSON array is invalid, or the index is invalid, an exception is thrown.

Example

 INT _arr
 _arr := %JSON_ArrayFromString('[[1,2,3],[4,5,6]]')
 
 INT _tmp
 _tmp := %JSON_ArrayGetArray(_arr, 1)

 %JSON_FreeArrayHandle(_tmp)
 %JSON_FreeArrayHandle(_arr)