openkylin
/
qemu
mirror of https://gitee.com/openkylin/qemu.git
9
0
Fork 0
Code Issues Projects Releases Wiki Activity

qapi: Make visit_next_list()'s comment less confusing 

visit_next_list() returns non-null on success, null on failure.  The
comment's phrasing "until NULL return or error occurs" is needlessly
confusing.  Scratch the "or error occurs" part.

Signed-off-by: Markus Armbruster <armbru@redhat.com>
Message-Id: <20190802122325.16520-1-armbru@redhat.com>
Reviewed-by: Eric Blake <eblake@redhat.com>
This commit is contained in:
Markus Armbruster 2019-08-02 14:23:25 +02:00
parent 2f93a3ecdd
commit 81b49004e0
1 changed files with 4 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
include/qapi/visitor.h
View File

@ -364,10 +364,10 @@ void visit_start_list(Visitor *v, const char *name, GenericList **list,
* @tail must not be NULL; on the first call, @tail is the value of * @tail must not be NULL; on the first call, @tail is the value of
* *list after visit_start_list(), and on subsequent calls @tail must * *list after visit_start_list(), and on subsequent calls @tail must
* be the previously returned value. Should be called in a loop until * be the previously returned value. Should be called in a loop until
* a NULL return or error occurs; for each non-NULL return, the caller * a NULL return; for each non-NULL return, the caller then calls the
* then calls the appropriate visit_type_*() for the element type of * appropriate visit_type_*() for the element type of the list, with
* the list, with that function's name parameter set to NULL and obj * that function's name parameter set to NULL and obj set to the
* set to the address of @tail->value. * address of @tail->value.
*/ */
GenericList *visit_next_list(Visitor *v, GenericList *tail, size_t size); GenericList *visit_next_list(Visitor *v, GenericList *tail, size_t size);