man rlist_new (Fonctions bibliothèques) - allocate a new rlist head
NAME
rlist_new - allocate a new rlist head
SYNOPSIS
#include <roy.h>
RList * rlist_new (void);
DESCRIPTION
Create a new toplevel struct to hold an rlist. This rlist is a doublely linked list that has both a head and a tail pointer. The RList struct is always the head of the rlist and should not be confused with an rlist entry struct, see rlist(3).
RETURN VALUE
This function should always succeed in returning an empty newly allocated RList pointer. This pointer is considered to be dynamicly allocated and should be freed by a call to rlist_free(3). For static allocation of an RList see rlist(3).
ERRORS
The rlist_new(3) call will never return any failure condition. Any out of memory issues are delt with by rmem(3) functions.
MACRO
SEE ALSO
rlist(3), rlist_append(3), rlist_compare(3), rlist_first(3), rlist_free(3), rlist_last(3), rlist_next(3), rlist_nth(3), rlist_prepend(3), rlist_prev(3), rlist_remove(3), roy(3)