mariadb/ut/ut0list.c

#include "ut0list.h"
#ifdef UNIV_NONINL
#include "ut0list.ic"
#endif

/********************************************************************
Create a new list. */
UNIV_INTERN
ib_list_t*
ib_list_create(void)
/*=================*/
			/* out: list */
{
	ib_list_t*	list = mem_alloc(sizeof(ib_list_t));

	list->first = NULL;
	list->last = NULL;
	list->is_heap_list = FALSE;

	return(list);
}

/********************************************************************
Create a new list using the given heap. ib_list_free MUST NOT BE CALLED for
lists created with this function. */
UNIV_INTERN
ib_list_t*
ib_list_create_heap(
/*================*/
				/* out: list */
	mem_heap_t*	heap)	/* in: memory heap to use */
{
	ib_list_t*	list = mem_heap_alloc(heap, sizeof(ib_list_t));

	list->first = NULL;
	list->last = NULL;
	list->is_heap_list = TRUE;

	return(list);
}

/********************************************************************
Free a list. */
UNIV_INTERN
void
ib_list_free(
/*=========*/
	ib_list_t*	list)	/* in: list */
{
	ut_a(!list->is_heap_list);

	/* We don't check that the list is empty because it's entirely valid
	to e.g. have all the nodes allocated from a single heap that is then
	freed after the list itself is freed. */

	mem_free(list);
}

/********************************************************************
Add the data to the start of the list. */
UNIV_INTERN
ib_list_node_t*
ib_list_add_first(
/*==============*/
				/* out: new list node*/
	ib_list_t*	list,	/* in: list */
	void*		data,	/* in: data */
	mem_heap_t*	heap)	/* in: memory heap to use */
{
	return(ib_list_add_after(list, ib_list_get_first(list), data, heap));
}

/********************************************************************
Add the data to the end of the list. */
UNIV_INTERN
ib_list_node_t*
ib_list_add_last(
/*=============*/
				/* out: new list node*/
	ib_list_t*	list,	/* in: list */
	void*		data,	/* in: data */
	mem_heap_t*	heap)	/* in: memory heap to use */
{
	return(ib_list_add_after(list, ib_list_get_last(list), data, heap));
}

/********************************************************************
Add the data after the indicated node. */
UNIV_INTERN
ib_list_node_t*
ib_list_add_after(
/*==============*/
					/* out: new list node*/
	ib_list_t*	list,		/* in: list */
	ib_list_node_t*	prev_node,	/* in: node preceding new node (can
					be NULL) */
	void*		data,		/* in: data */
	mem_heap_t*	heap)		/* in: memory heap to use */
{
	ib_list_node_t*	node = mem_heap_alloc(heap, sizeof(ib_list_node_t));

	node->data = data;

	if (!list->first) {
		/* Empty list. */

		ut_a(!prev_node);

		node->prev = NULL;
		node->next = NULL;

		list->first = node;
		list->last = node;
	} else if (!prev_node) {
		/* Start of list. */

		node->prev = NULL;
		node->next = list->first;

		list->first->prev = node;

		list->first = node;
	} else {
		/* Middle or end of list. */

		node->prev = prev_node;
		node->next = prev_node->next;

		prev_node->next = node;

		if (node->next) {
			node->next->prev = node;
		} else {
			list->last = node;
		}
	}

	return(node);
}

/********************************************************************
Remove the node from the list. */
UNIV_INTERN
void
ib_list_remove(
/*===========*/
	ib_list_t*	list,	/* in: list */
	ib_list_node_t*	node)	/* in: node to remove */
{
	if (node->prev) {
		node->prev->next = node->next;
	} else {
		/* First item in list. */

		ut_ad(list->first == node);

		list->first = node->next;
	}

	if (node->next) {
		node->next->prev = node->prev;
	} else {
		/* Last item in list. */

		ut_ad(list->last == node);

		list->last = node->prev;
	}
}