![]() |
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.
| [in] | list_to_add | the list_object of the JSON data hierarchy to add the new Member to. |
| [in] | member_name | pointer 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_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 |