/** * @file linked_list.c * * @brief Implementation of linked_list_t. * */ /* * Copyright (C) 2005-2006 Martin Willi * Copyright (C) 2005 Jan Hutter * Hochschule fuer Technik Rapperswil * * This program is free software; you can redistribute it and/or modify it * under the terms of the GNU General Public License as published by the * Free Software Foundation; either version 2 of the License, or (at your * option) any later version. See . * * This program is distributed in the hope that it will be useful, but * WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY * or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License * for more details. */ #include #include "linked_list.h" typedef struct element_t element_t; /** * This element holds a pointer to the value it represents. */ struct element_t { /** * Value of a list item. */ void *value; /** * Previous list element. * * NULL if first element in list. */ element_t *previous; /** * Next list element. * * NULL if last element in list. */ element_t *next; }; /** * Creates an empty linked list object. */ element_t *element_create(void *value) { element_t *this = malloc_thing(element_t); this->previous = NULL; this->next = NULL; this->value = value; return (this); } typedef struct private_linked_list_t private_linked_list_t; /** * Private data of a linked_list_t object. * */ struct private_linked_list_t { /** * Public part of linked list. */ linked_list_t public; /** * Number of items in the list. */ int count; /** * First element in list. * NULL if no elements in list. */ element_t *first; /** * Last element in list. * NULL if no elements in list. */ element_t *last; }; typedef struct private_iterator_t private_iterator_t; /** * Private variables and functions of linked list iterator. */ struct private_iterator_t { /** * Public part of linked list iterator. */ iterator_t public; /** * Associated linked list. */ private_linked_list_t * list; /** * Current element of the iterator. */ element_t *current; /** * Direction of iterator. */ bool forward; /** * Mutex to use to synchronize access */ pthread_mutex_t *mutex; /** * iteration hook */ iterator_hook_t *hook; /** * user parameter for iterator hook */ void *hook_param; }; /** * Implementation of iterator_t.get_count. */ static int get_list_count(private_iterator_t *this) { return this->list->count; } /** * default iterator hook which does nothing */ static hook_result_t iterator_hook(void *param, void *in, void **out) { *out = in; return HOOK_NEXT; } /** * Implementation of iterator_t.set_iterator_hook. */ static void set_iterator_hook(private_iterator_t *this, iterator_hook_t *hook, void* param) { if (hook == NULL) { this->hook = iterator_hook; this->hook_param = NULL; } else { this->hook = hook; this->hook_param = param; } } /** * Implementation of iterator_t.iterate. */ static bool iterate(private_iterator_t *this, void** value) { while (TRUE) { if (this->forward) { this->current = this->current ? this->current->next : this->list->first; } else { this->current = this->current ? this->current->previous : this->list->last; } if (this->current == NULL) { return FALSE; } switch (this->hook(this->hook_param, this->current->value, value)) { case HOOK_AGAIN: /* rewind */ if (this->forward) { this->current = this->current->previous; } else { this->current = this->current->next; } break; case HOOK_NEXT: /* normal iteration */ break; case HOOK_SKIP: /* advance */ continue; } break; } return TRUE; } /** * Implementation of iterator_t.reset. */ static void iterator_reset(private_iterator_t *this) { this->current = NULL; } /** * Implementation of iterator_t.remove. */ static status_t remove_(private_iterator_t *this) { element_t *new_current; if (this->current == NULL) { return NOT_FOUND; } if (this->list->count == 0) { return NOT_FOUND; } /* find out the new iterator position, depending on iterator direction */ if (this->forward && this->current->previous != NULL) { new_current = this->current->previous; } else if (!this->forward && this->current->next != NULL) { new_current = this->current->next; } else { new_current = NULL; } /* now delete the entry :-) */ if (this->current->previous == NULL) { if (this->current->next == NULL) { this->list->first = NULL; this->list->last = NULL; } else { this->current->next->previous = NULL; this->list->first = this->current->next; } } else if (this->current->next == NULL) { this->current->previous->next = NULL; this->list->last = this->current->previous; } else { this->current->previous->next = this->current->next; this->current->next->previous = this->current->previous; } this->list->count--; free(this->current); /* set the new iterator position */ this->current = new_current; return SUCCESS; } /** * Implementation of iterator_t.insert_before. */ static void insert_before(private_iterator_t * iterator, void *item) { if (iterator->current == NULL) { iterator->list->public.insert_first(&(iterator->list->public), item); } element_t *element = element_create(item); if (iterator->current->previous == NULL) { iterator->current->previous = element; element->next = iterator->current; iterator->list->first = element; } else { iterator->current->previous->next = element; element->previous = iterator->current->previous; iterator->current->previous = element; element->next = iterator->current; } iterator->list->count++; } /** * Implementation of iterator_t.replace. */ static status_t replace(private_iterator_t *this, void **old_item, void *new_item) { if (this->current == NULL) { return NOT_FOUND; } if (old_item != NULL) { *old_item = this->current->value; } this->current->value = new_item; return SUCCESS; } /** * Implementation of iterator_t.insert_after. */ static void insert_after(private_iterator_t *iterator, void *item) { if (iterator->current == NULL) { iterator->list->public.insert_first(&(iterator->list->public),item); return; } element_t *element = element_create(item); if (iterator->current->next == NULL) { iterator->current->next = element; element->previous = iterator->current; iterator->list->last = element; } else { iterator->current->next->previous = element; element->next = iterator->current->next; iterator->current->next = element; element->previous = iterator->current; } iterator->list->count++; } /** * Implementation of iterator_t.destroy. */ static void iterator_destroy(private_iterator_t *this) { if (this->mutex) { pthread_mutex_unlock(this->mutex); } free(this); } /** * Implementation of linked_list_t.get_count. */ static int get_count(private_linked_list_t *this) { return this->count; } /** * Implementation of linked_list_t.insert_first. */ static void insert_first(private_linked_list_t *this, void *item) { element_t *element; element = element_create(item); if (this->count == 0) { /* first entry in list */ this->first = element; this->last = element; element->previous = NULL; element->next = NULL; } else { element_t *old_first_element = this->first; element->next = old_first_element; element->previous = NULL; old_first_element->previous = element; this->first = element; } this->count++; } /** * Implementation of linked_list_t.remove_first. */ static status_t remove_first(private_linked_list_t *this, void **item) { element_t *element = this->first; if (element == NULL) { return NOT_FOUND; } if (element->next != NULL) { element->next->previous = NULL; } this->first = element->next; if (item != NULL) { *item = element->value; } if (--this->count == 0) { this->last = NULL; } free(element); return SUCCESS; } /** * Implementation of linked_list_t.get_first. */ static status_t get_first(private_linked_list_t *this, void **item) { if (this->count == 0) { return NOT_FOUND; } *item = this->first->value; return SUCCESS; } /** * Implementation of linked_list_t.insert_last. */ static void insert_last(private_linked_list_t *this, void *item) { element_t *element = element_create(item); if (this->count == 0) { /* first entry in list */ this->first = element; this->last = element; element->previous = NULL; element->next = NULL; } else { element_t *old_last_element = this->last; element->previous = old_last_element; element->next = NULL; old_last_element->next = element; this->last = element; } this->count++; } /** * Implementation of linked_list_t.remove_last. */ static status_t remove_last(private_linked_list_t *this, void **item) { element_t *element = this->last; if (element == NULL) { return NOT_FOUND; } if (element->previous != NULL) { element->previous->next = NULL; } this->last = element->previous; if (item != NULL) { *item = element->value; } if (--this->count == 0) { this->first = NULL; } free(element); return SUCCESS; } /** * Implementation of linked_list_t.insert_at_position. */ static status_t insert_at_position (private_linked_list_t *this,size_t position, void *item) { element_t *current_element; int i; if (this->count <= position) { return INVALID_ARG; } current_element = this->first; for (i = 0; i < position;i++) { current_element = current_element->next; } if (current_element == NULL) { this->public.insert_last(&(this->public),item); return SUCCESS; } element_t *element = element_create(item); if (current_element->previous == NULL) { current_element->previous = element; element->next = current_element; this->first = element; } else { current_element->previous->next = element; element->previous = current_element->previous; current_element->previous = element; element->next = current_element; } this->count++; return SUCCESS; } /** * Implementation of linked_list_t.remove_at_position. */ static status_t remove_at_position(private_linked_list_t *this,size_t position, void **item) { iterator_t *iterator; int i; if (this->count <= position) { return INVALID_ARG; } iterator = this->public.create_iterator(&(this->public),TRUE); iterator->iterate(iterator, item); for (i = 0; i < position; i++) { if (!iterator->iterate(iterator, item)) { iterator->destroy(iterator); return INVALID_ARG; } } iterator->remove(iterator); iterator->destroy(iterator); return SUCCESS; } /** * Implementation of linked_list_t.get_at_position. */ static status_t get_at_position(private_linked_list_t *this,size_t position, void **item) { int i; iterator_t *iterator; if (this->count <= position) { return INVALID_ARG; } iterator = this->public.create_iterator(&(this->public),TRUE); iterator->iterate(iterator, item); for (i = 0; i < position; i++) { if (!iterator->iterate(iterator, item)) { iterator->destroy(iterator); return INVALID_ARG; } } iterator->destroy(iterator); return SUCCESS; } /** * Implementation of linked_list_t.get_last. */ static status_t get_last(private_linked_list_t *this, void **item) { if (this->count == 0) { return NOT_FOUND; } *item = this->last->value; return SUCCESS; } /** * Implementation of linked_list_t.invoke. */ static void invoke(private_linked_list_t *this, size_t offset) { element_t *current = this->first; while (current) { void (**method)(void*) = current->value + offset; (*method)(current->value); current = current->next; } } /** * Implementation of linked_list_t.destroy. */ static void destroy(private_linked_list_t *this) { void *value; /* Remove all list items before destroying list */ while (this->public.remove_first(&(this->public), &value) == SUCCESS) { /* values are not destroyed so memory leaks are possible * if list is not empty when deleting */ } free(this); } /** * Implementation of linked_list_t.destroy_offset. */ static void destroy_offset(private_linked_list_t *this, size_t offset) { element_t *current = this->first, *next; while (current) { void (**method)(void*) = current->value + offset; (*method)(current->value); next = current->next; free(current); current = next; } free(this); } /** * Implementation of linked_list_t.destroy_function. */ static void destroy_function(private_linked_list_t *this, void (*fn)(void*)) { element_t *current = this->first, *next; while (current) { fn(current->value); next = current->next; free(current); current = next; } free(this); } /** * Implementation of linked_list_t.create_iterator. */ static iterator_t *create_iterator(private_linked_list_t *linked_list, bool forward) { private_iterator_t *this = malloc_thing(private_iterator_t); this->public.get_count = (int (*) (iterator_t*)) get_list_count; this->public.iterate = (bool (*) (iterator_t*, void **value)) iterate; this->public.set_iterator_hook = (void(*)(iterator_t*, iterator_hook_t*, void*))set_iterator_hook; this->public.insert_before = (void (*) (iterator_t*, void *item)) insert_before; this->public.insert_after = (void (*) (iterator_t*, void *item)) insert_after; this->public.replace = (status_t (*) (iterator_t*, void **, void *)) replace; this->public.remove = (status_t (*) (iterator_t*)) remove_; this->public.reset = (void (*) (iterator_t*)) iterator_reset; this->public.destroy = (void (*) (iterator_t*)) iterator_destroy; this->forward = forward; this->current = NULL; this->list = linked_list; this->mutex = NULL; this->hook = iterator_hook; return &this->public; } /** * Implementation of linked_list_t.create_iterator_locked. */ static iterator_t *create_iterator_locked(private_linked_list_t *linked_list, pthread_mutex_t *mutex) { private_iterator_t *this = (private_iterator_t*)create_iterator(linked_list, TRUE); this->mutex = mutex; pthread_mutex_lock(mutex); return &this->public; } /* * Described in header. */ linked_list_t *linked_list_create() { private_linked_list_t *this = malloc_thing(private_linked_list_t); this->public.get_count = (int (*) (linked_list_t *)) get_count; this->public.create_iterator = (iterator_t * (*) (linked_list_t *,bool))create_iterator; this->public.create_iterator_locked = (iterator_t * (*) (linked_list_t *,pthread_mutex_t*))create_iterator_locked; this->public.get_first = (status_t (*) (linked_list_t *, void **item))get_first; this->public.get_last = (status_t (*) (linked_list_t *, void **item))get_last; this->public.insert_first = (void (*) (linked_list_t *, void *item))insert_first; this->public.insert_last = (void (*) (linked_list_t *, void *item))insert_last; this->public.remove_first = (status_t (*) (linked_list_t *, void **item))remove_first; this->public.remove_last = (status_t (*) (linked_list_t *, void **item))remove_last; this->public.insert_at_position = (status_t (*) (linked_list_t *,size_t, void *))insert_at_position; this->public.remove_at_position = (status_t (*) (linked_list_t *,size_t, void **))remove_at_position; this->public.get_at_position = (status_t (*) (linked_list_t *,size_t, void **))get_at_position; this->public.invoke = (void (*)(linked_list_t*,size_t))invoke; this->public.destroy = (void (*) (linked_list_t *))destroy; this->public.destroy_offset = (void (*) (linked_list_t *,size_t))destroy_offset; this->public.destroy_function = (void (*)(linked_list_t*,void(*)(void*)))destroy_function; this->count = 0; this->first = NULL; this->last = NULL; return &this->public; }