%JSON_ArrayAppendObject function

Function

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

Declaration

%JSON_ArrayAppendObject(
    INT in handle, 
    INT in object
 )

Parameters

handle	Handle to parent JSON array.
array	Handle to JSON object.

Return value

None.

Description

The function appends a new object at the end of the JSON array.

If it is an invalid handle on a JSON array or an invalid handle on an appended JSON object, an exception is thrown.

If the array is shared, the change is visible also in the parent object or array. See Sharing of arrays.

Example

 INT _arr
 _arr := %JSON_CreateArray()

 INT _tmp
 _tmp := %JSON_CreateObject()
 
 %JSON_ArrayAppendObject(_arr, _tmp)

 %JSON_FreeArrayHandle(_arr)
 %JSON_FreeObjectHandle(_tmp)