JSON Parser  1.0
int json_list_object_member_add_list ( list_object *  list_to_add,
const char *  member_name,
list_object *  new_list,
const JSON_value_types  list_type 
)

Add a new Member with a JSON Array or JSON Object value to an existing JSON Object, defined by the list_object provided.

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

So either { "member_name" : { } } or { "member_name" : [ ] }

The caller must have previously created the new list_object to add as a Member to this JSON Object, and provide it in argument #3 (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 Object. 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_addthe list_object of the JSON data hierarchy to add the new Member to.
[in]member_namepointer to a nul terminated string to use as the JSON Object Member Name, this argument is required both by this function, and by JSON Standards RFC 8259.
[in]new_listthe list_object of the new JSON Array or Object to add to the existing JSON Object as a new Member.
[in]list_typemust be either JSON_object or JSON_array.
\retval     LIST_OK             success, new element added to the list
\retval         LIST_ERR            on error