Man page - rc_stringlist_sort(3)

Packages contains this manual

Manual


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 ALSO

malloc (3), free (3), queue (3), strcmp (3)

AUTHORS

Roy Marples <roy@marples.name> OpenRC Mar 16, 2008 RC_STRLIST (3)