RC_STRLIST(3) | Library Functions Manual (smm) | RC_STRLIST(3) |
NAME¶
rc_stringlist_add
,
rc_stringlist_addu
,
rc_stringlist_delete
,
rc_stringlist_free
,
rc_stringlist_new
,
rc_stringlist_sort
—
LIBRARY¶
Run Command library (librc, -lrc)SYNOPSIS¶
#include <rc.h>
RC_STRINGLIST *
rc_stringlist_new
(void);
RC_STRING *
rc_stringlist_add
(RC_STRINGLIST
*list, const char
*item);
RC_STRING *
rc_stringlist_addu
(RC_STRINGLIST
*list, const char
*item);
bool
rc_stringlist_delete
(RC_STRINGLIST,
const char *item);
void
rc_stringlist_free
(RC_STRINGLIST
*list);
void
rc_stringlist_sort
(RC_STRINGLIST
*list);
DESCRIPTION¶
These functions provide an easy means of manipulating string lists. They are basically wrappers around TAILQ macros found in queue(3).rc_stringlist_new
() creates a new list
head to store the list.
rc_stringlist_add
() adds a malloced copy
of item to list. It returns a
pointer to the new item on success, or NULL on failure and sets
errno accordingly.
rc_stringlist_addu
() only works if
list does not already contain
item.
rc_stringlist_delete
() removes and frees
item from list, retuning true on
success, otherwise false.
rc_stringlist_sort
() sorts the
list according to C locale.
rc_stringlist_free
() frees each item on
list and the list itself.
SEE ALSO¶
malloc(3), free(3), queue(3), strcmp(3)AUTHORS¶
Roy Marples <roy@marples.name>March 16, 2008 | OpenRC |