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 ALSO¶
malloc(3),
free(3),
queue(3),
strcmp(3)
AUTHORS¶
Roy Marples <roy@marples.name>
