%JSON_ArraySetObject function

Function

Replaces an item at a given index in the JSON array by object.

Declaration

%JSON_ArraySetObject(
    INT in handle, 
    INT in index,
    INT in object
 )

Parameters

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

Return value

None

Description

Function replaces an item at a given index in the JSON array by object.

Exception is thrown if handle to parent JSON array is invalid, handle to object is invalid or index is out of range.

If the array is shared, the handle gets a private copy of the array and the change is not visible in the parent object or array. See Sharing of arrays.

Example

 INT _arr
 _arr := %JSON_CreateArray()

 INT _tmp
 _tmp := %JSON_CreateObject()
 
 %JSON_ArraySetLength(_arr, 1)
 %JSON_ArraySetObject(_arr, 1, _tmp)

 %JSON_FreeArrayHandle(_arr)
 %JSON_FreeObjectHandle(_tmp)