%JSON_ArrayAppendArray function

Function

Appends a new array at the end of the JSON array.

Declaration

%JSON_ArrayAppendArray(
    INT in handle, 
    INT in array
 )

Parameters

handle	Handle to the JSON array into which the new item will be inserted.
array	Handle to JSON array.

Return value

None.

Description

The function inserts a new array at the end of the JSON array.

An exception is thrown if it is an invalid JSON array handle or an invalid JSON array handle.

The inserted array is not copied – the handle of the inserted array and the new item point to the same array. If the target array is shared, the change is visible also in its parent object or array. See Sharing of arrays.

Example

 INT _arr
 _arr := %JSON_CreateArray()

 INT _tmp
 _tmp := %JSON_CreateArray()
 
 %JSON_ArrayAppendArray(_arr, _tmp)

 %JSON_FreeArrayHandle(_arr)
 %JSON_FreeArrayHandle(_tmp)