strlist -- dynamically growing list of strings
#include <afblib/strlist.h>
typedef struct strlist {
char** list;
size_t len;
size_t allocated;
} strlist;
bool strlist_ready(strlist* list, size_t len); bool strlist_readyplus(strlist* list, size_t len); void strlist_clear(strlist* list); bool strlist_push(strlist* list, char* string); bool strlist_push0(strlist* list); void strlist_free(strlist* list);
Objects of type strlist represent lists of character strings. Any number of strings may be added to such a list. Already added list members cannot be removed except by clearing the whole list. This data structure is mainly useful in building up arguments lists, e.g. for execvp.
There is no function that creates or initializes a list. Instead an initializer is to be used:
strlist argv = {0};
strlist objects grow by themselves. However, if the number of elements can be estimated or is known, it might be preferably to use strlist_read to assure that there is space ready allocated for at least len entries. strlist_readyplus works similar to strlist_ready but adds implicitly the current number of list members to len.
strlist_clear empties the entire list. strlist_push adds the given string to the list. strlist_push0 adds a null-pointer to the list. This is particularly useful in case of null-pointer-terminated argument or environment lists.
strlist_free frees the allocated memory associated with list.
Andreas F. Borchert