int json_list_object_array_value_add_list	(	list_object *	list_to_add,
		list_object *	new_list,
		const JSON_value_types	list_type
	)

Add a new data value to an existing JSON Array, that has as a value type of either a JSON Array or JSON Object, defined by the list_object provided.

This function will add a new JSON value to the provided Array list_object at the last position of that list, this value will not have a data value, but will instead open either a new Array of values, or a new JSON Object.

So either [ ..., { } ] or [ .., [ ] ]

The caller must have previously created the new list_object to add as the value element to this JSON Array, and provide it in argument #2 (new_list).

If there are already elements in this list_object, then they are used to confirm that the list_object requested, is actually a JSON Array. If this is the first element to be added, then as no check can be made, it is assumed the caller is providing a Member to a valid JSON list type. If the list type is incorrect, an error will be thrown up when the second element is added.

Parameters

[in]	list_to_add	the list_object of the JSON data hierarchy to add the new Member to.
[in]	new_list	the list_object of the new JSON Array or Object to add to the existing JSON Object as a new Member.
[in]	list_type	must be either JSON_object or JSON_array. \retval LIST_OK success, new element added to the list \retval LIST_ERR on error