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

The rlist_new(3) api is implemented using a macro.

SEE ALSO