Document refcount of json_tokener_parse_ex return

This commit is contained in:
Christopher Head
2018-08-30 09:18:29 -07:00
parent 0a8ac2ed92
commit 31d4d3dee7

View File

@@ -155,9 +155,10 @@ JSON_EXPORT void json_tokener_set_flags(struct json_tokener *tok, int flags);
* called. * called.
* *
* When a valid JSON value is parsed, a non-NULL json_object will be * When a valid JSON value is parsed, a non-NULL json_object will be
* returned. Also, json_tokener_get_error() will return json_tokener_success. * returned, with a reference count of one which belongs to the caller. Also,
* Be sure to check the type with json_object_is_type() or * json_tokener_get_error() will return json_tokener_success. Be sure to check
* json_object_get_type() before using the object. * the type with json_object_is_type() or json_object_get_type() before using
* the object.
* *
* @b XXX this shouldn't use internal fields: * @b XXX this shouldn't use internal fields:
* Trailing characters after the parsed value do not automatically cause an * Trailing characters after the parsed value do not automatically cause an