diff options
author | Brant Thomsen <brant.thomsen@harman.com> | 2017-07-14 16:05:31 -0600 |
---|---|---|
committer | Brant Thomsen <brant.thomsen@harman.com> | 2017-07-14 16:05:31 -0600 |
commit | 7ce324d6c05057710f4db3f6bb989537c066275a (patch) | |
tree | b5d26445107a215624030167aabb73e7e91c65a7 | |
parent | 967fd6a84d0e8025f4eb5155a7af51b04cb153d8 (diff) | |
download | Open-AVB-7ce324d6c05057710f4db3f6bb989537c066275a.tar.gz |
openavb_list comment cleanup
Added more details to the description comments for openavbListAdd() and
openavbListNew().
Clarified that several functions will return NULL rather than FALSE.
-rw-r--r-- | lib/avtp_pipeline/util/openavb_list.h | 20 |
1 files changed, 10 insertions, 10 deletions
diff --git a/lib/avtp_pipeline/util/openavb_list.h b/lib/avtp_pipeline/util/openavb_list.h index e1c2af15..15826464 100644 --- a/lib/avtp_pipeline/util/openavb_list.h +++ b/lib/avtp_pipeline/util/openavb_list.h @@ -49,37 +49,37 @@ openavb_list_t openavbListNewList(void); // Delete a link list. void openavbListDeleteList(openavb_list_t list); -// Add a data element as a node to a link list. Returns NULL on failure. +// Add a data element as a node to the end (tail) of a link list. Returns NULL on failure. openavb_list_node_t openavbListAdd(openavb_list_t list, void *data); -// Allocate and manage data element and add as a node to a link list. Returns NULL on failure. +// Allocate and manage data element and add as a node to the end (tail) of a link list. Returns NULL on failure. openavb_list_node_t openavbListNew(openavb_list_t list, U32 size); // Remove (delete) node. Returns NULL on failure otherwise next node. openavb_list_node_t openavbListDelete(openavb_list_t list, openavb_list_node_t node); -// Gets the next node. Returns FALSE on error or if already at the tail. +// Gets the next node. Returns NULL on error or if already at the tail. openavb_list_node_t openavbListNext(openavb_list_t list, openavb_list_node_t node); -// Gets the previous node. Returns FALSE on error or if already at the head. +// Gets the previous node. Returns NULL on error or if already at the head. openavb_list_node_t openavbListPrev(openavb_list_t list, openavb_list_node_t node); -// Gets the first (head) node. Returns FALSE on error or empty list. +// Gets the first (head) node. Returns NULL on error or empty list. openavb_list_node_t openavbListFirst(openavb_list_t list); -// Gets the lastt (tail) node. Returns FALSE on error or empty list. +// Gets the last (tail) node. Returns NULL on error or empty list. openavb_list_node_t openavbListLast(openavb_list_t list); -// Gets the first node and preps for iteration. Returns FALSE on error or empty list. +// Gets the first node and preps for iteration. Returns NULL on error or empty list. openavb_list_node_t openavbListIterFirst(openavb_list_t list); -// Gets the last node and preps for iteration. Returns FALSE on error or empty list. +// Gets the last node and preps for iteration. Returns NULL on error or empty list. openavb_list_node_t openavbListIterLast(openavb_list_t list); -// Gets the next node in the iteration. Returns FALSE on error or end of list. +// Gets the next node in the iteration. Returns NULL on error or end of list. openavb_list_node_t openavbListIterNext(openavb_list_t list); -// Gets the prev node in the iteration. Returns FALSE on error or beginning of list. +// Gets the previous node in the iteration. Returns NULL on error or beginning of list. openavb_list_node_t openavbListIterPrev(openavb_list_t list); // Get data element. Returns NULL on failure. |