RC_STRLIST(3) System Manager's Manual RC_STRLIST(3)NAME
rc_stringlist_add, rc_stringlist_addu, rc_stringlist_delete,
rc_stringlist_free, rc_stringlist_new, rc_stringlist_sort — RC string
list functions
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 ALSOmalloc(3), free(3), queue(3), strcmp(3)AUTHORS
Roy Marples <roy@marples.name>
OpenRC Mar 16, 2008 OpenRC