list.h

Go to the documentation of this file.

/*
 * Copyright (c) 2001-2004 Jakub Jermar
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 *
 * - Redistributions of source code must retain the above copyright
 *   notice, this list of conditions and the following disclaimer.
 * - Redistributions in binary form must reproduce the above copyright
 *   notice, this list of conditions and the following disclaimer in the
 *   documentation and/or other materials provided with the distribution.
 * - The name of the author may not be used to endorse or promote products
 *   derived from this software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 */

#ifndef LIBC_LIST_H_
#define LIBC_LIST_H_

#include <unistd.h>

typedef struct link {
        struct link *prev;  
        struct link *next;  
} link_t;

#define LIST_INITIALIZE(name) \
        link_t name = { \
                .prev = &name, \
                .next = &name \
        }

#define list_get_instance(link, type, member) \
        ((type *) (((void *)(link)) - ((void *) &(((type *) NULL)->member))))

#define list_foreach(list, iterator) \
        for (link_t *iterator = (list).next; \
            iterator != &(list); iterator = iterator->next)

static inline void link_initialize(link_t *link)
{
        link->prev = NULL;
        link->next = NULL;
}

static inline void list_initialize(link_t *list)
{
        list->prev = list;
        list->next = list;
}

static inline void list_prepend(link_t *link, link_t *list)
{
        link->next = list->next;
        link->prev = list;
        list->next->prev = link;
        list->next = link;
}

static inline void list_append(link_t *link, link_t *list)
{
        link->prev = list->prev;
        link->next = list;
        list->prev->next = link;
        list->prev = link;
}

static inline void list_insert_before(link_t *link, link_t *list)
{
        list_append(link, list);
}

static inline void list_insert_after(link_t *link, link_t *list)
{
        list_prepend(list, link);
}

static inline void list_remove(link_t *link)
{
        link->next->prev = link->prev;
        link->prev->next = link->next;
        link_initialize(link);
}

static inline int list_empty(link_t *list)
{
        return (list->next == list);
}

static inline link_t *list_head(link_t *list)
{
        return ((list->next == list) ? NULL : list->next);
}

static inline void headless_list_split_or_concat(link_t *part1, link_t *part2)
{
        part1->prev->next = part2;
        part2->prev->next = part1;
        
        link_t *hlp = part1->prev;
        
        part1->prev = part2->prev;
        part2->prev = hlp;
}

static inline void headless_list_split(link_t *part1, link_t *part2)
{
        headless_list_split_or_concat(part1, part2);
}

static inline void headless_list_concat(link_t *part1, link_t *part2)
{
        headless_list_split_or_concat(part1, part2);
}

static inline link_t *list_nth(link_t *list, unsigned int n)
{
        unsigned int cnt = 0;
        
        list_foreach(*list, link) {
                if (cnt == n)
                        return link;
                
                cnt++;
        }
        
        return NULL;
}

extern int list_member(const link_t *, const link_t *);
extern void list_concat(link_t *, link_t *);
extern unsigned int list_count(const link_t *);

#endif

---