list_pop_head function <BLOC/list.h>

The list_pop_head function pops (removes and returns a reference to) the first item from a list. This function can be used to treat a list like a queue.

Syntax

void *
list_pop_head(
	List *list
);

Parameters

A pointer to a List object.

Return value

A reference to the removed item. If the list was empty, the function returns NULL.