r6:Function:slist new head

Source Files

/src/slist/slist_new.c
/inc/liblfds.h

Prototype

struct slist_element *slist_new_head( struct slist_state *ss, void *user_data );

Parameters

struct slist_state *ss

An slist state as allocated by slist_new.

void *user_data

A void pointer of user data which will be placed into the list in the new head element.

Return Value

Returns a pointer to the new slist element. If element creation failed, which can only happen because of memory allocation failure, the return value is NULL.

Notes

This function creates a new slist element holding user_data and links it into the slist as the head element.

See Also

• SList
• slist_new_next