Ignore:
File:
1 edited

Legend:

Unmodified
Added
Removed
  • kernel/generic/include/adt/list.h

    r74464e8 r0a02653  
    11/*
    22 * Copyright (c) 2001-2004 Jakub Jermar
    3  * Copyright (c) 2011 Jiri Svoboda
    43 * All rights reserved.
    54 *
     
    4039#include <trace.h>
    4140
    42 /** Doubly linked list link. */
     41/** Doubly linked list head and link type. */
    4342typedef struct link {
    4443        struct link *prev;  /**< Pointer to the previous item in the list. */
     
    4645} link_t;
    4746
    48 /** Doubly linked list. */
    49 typedef struct list {
    50         link_t head;  /**< List head. Does not have any data. */
    51 } list_t;
    52 
    5347/** Declare and initialize statically allocated list.
    5448 *
     
    5751 */
    5852#define LIST_INITIALIZE(name) \
    59         list_t name = { \
    60                 .head = { \
    61                         .prev = &(name).head, \
    62                         .next = &(name).head \
    63                 } \
     53        link_t name = { \
     54                .prev = &name, \
     55                .next = &name \
    6456        }
    6557
     
    6860
    6961#define list_foreach(list, iterator) \
    70         for (link_t *iterator = (list).head.next; \
    71             iterator != &(list).head; iterator = iterator->next)
    72 
    73 #define assert_link_not_used(link) \
    74         ASSERT((link)->prev == NULL && (link)->next == NULL)
     62        for (link_t *iterator = (list).next; \
     63            iterator != &(list); iterator = iterator->next)
    7564
    7665/** Initialize doubly-linked circular list link
     
    9180 * Initialize doubly-linked circular list.
    9281 *
    93  * @param list Pointer to list_t structure.
    94  *
    95  */
    96 NO_TRACE static inline void list_initialize(list_t *list)
    97 {
    98         list->head.prev = &list->head;
    99         list->head.next = &list->head;
     82 * @param list Pointer to link_t structure representing the list.
     83 *
     84 */
     85NO_TRACE static inline void list_initialize(link_t *list)
     86{
     87        list->prev = list;
     88        list->next = list;
     89}
     90
     91/** Add item to the beginning of doubly-linked circular list
     92 *
     93 * Add item to the beginning of doubly-linked circular list.
     94 *
     95 * @param link Pointer to link_t structure to be added.
     96 * @param list Pointer to link_t structure representing the list.
     97 *
     98 */
     99NO_TRACE static inline void list_prepend(link_t *link, link_t *list)
     100{
     101        link->next = list->next;
     102        link->prev = list;
     103        list->next->prev = link;
     104        list->next = link;
     105}
     106
     107/** Add item to the end of doubly-linked circular list
     108 *
     109 * Add item to the end of doubly-linked circular list.
     110 *
     111 * @param link Pointer to link_t structure to be added.
     112 * @param list Pointer to link_t structure representing the list.
     113 *
     114 */
     115NO_TRACE static inline void list_append(link_t *link, link_t *list)
     116{
     117        link->prev = list->prev;
     118        link->next = list;
     119        list->prev->next = link;
     120        list->prev = link;
    100121}
    101122
     
    103124 *
    104125 */
    105 static inline void list_insert_before(link_t *lnew, link_t *lold)
    106 {
    107         lnew->next = lold;
    108         lnew->prev = lold->prev;
    109         lold->prev->next = lnew;
    110         lold->prev = lnew;
     126static inline void list_insert_before(link_t *link, link_t *list)
     127{
     128        list_append(link, list);
    111129}
    112130
     
    114132 *
    115133 */
    116 static inline void list_insert_after(link_t *lnew, link_t *lold)
    117 {
    118         lnew->prev = lold;
    119         lnew->next = lold->next;
    120         lold->next->prev = lnew;
    121         lold->next = lnew;
    122 }
    123 
    124 /** Add item to the beginning of doubly-linked circular list
    125  *
    126  * Add item to the beginning of doubly-linked circular list.
    127  *
    128  * @param link Pointer to link_t structure to be added.
    129  * @param list Pointer to list_t structure.
    130  *
    131  */
    132 NO_TRACE static inline void list_prepend(link_t *link, list_t *list)
    133 {
    134         list_insert_after(link, &list->head);
    135 }
    136 
    137 /** Add item to the end of doubly-linked circular list
    138  *
    139  * Add item to the end of doubly-linked circular list.
    140  *
    141  * @param link Pointer to link_t structure to be added.
    142  * @param list Pointer to list_t structure.
    143  *
    144  */
    145 NO_TRACE static inline void list_append(link_t *link, list_t *list)
    146 {
    147         list_insert_before(link, &list->head);
     134static inline void list_insert_after(link_t *link, link_t *list)
     135{
     136        list_prepend(list, link);
    148137}
    149138
     
    167156 * Query emptiness of doubly-linked circular list.
    168157 *
    169  * @param list Pointer to lins_t structure.
    170  *
    171  */
    172 NO_TRACE static inline int list_empty(list_t *list)
    173 {
    174         return (list->head.next == &list->head);
    175 }
    176 
    177 /** Get first item in list.
    178  *
    179  * @param list Pointer to list_t structure.
     158 * @param list Pointer to link_t structure representing the list.
     159 *
     160 */
     161NO_TRACE static inline int list_empty(link_t *list)
     162{
     163        return (list->next == list);
     164}
     165
     166/** Get head item of a list.
     167 *
     168 * @param list Pointer to link_t structure representing the list.
    180169 *
    181170 * @return Head item of the list.
     
    183172 *
    184173 */
    185 static inline link_t *list_first(list_t *list)
    186 {
    187         return ((list->head.next == &list->head) ? NULL : list->head.next);
    188 }
    189 
    190 /** Get last item in list.
    191  *
    192  * @param list Pointer to list_t structure.
    193  *
    194  * @return Head item of the list.
    195  * @return NULL if the list is empty.
    196  *
    197  */
    198 static inline link_t *list_last(list_t *list)
    199 {
    200         return ((list->head.prev == &list->head) ? NULL : list->head.prev);
     174static inline link_t *list_head(link_t *list)
     175{
     176        return ((list->next == list) ? NULL : list->next);
    201177}
    202178
     
    255231}
    256232
    257 /** Get n-th item in a list.
     233/** Get n-th item of a list.
    258234 *
    259235 * @param list Pointer to link_t structure representing the list.
     
    264240 *
    265241 */
    266 static inline link_t *list_nth(list_t *list, unsigned int n)
     242static inline link_t *list_nth(link_t *list, unsigned int n)
    267243{
    268244        unsigned int cnt = 0;
     
    278254}
    279255
    280 extern int list_member(const link_t *, const list_t *);
    281 extern void list_concat(list_t *, list_t *);
    282 extern unsigned int list_count(const list_t *);
     256extern int list_member(const link_t *, const link_t *);
     257extern void list_concat(link_t *, link_t *);
     258extern unsigned int list_count(const link_t *);
    283259
    284260#endif
Note: See TracChangeset for help on using the changeset viewer.