sl_add(3)

NAME

stringlist, sl_init, sl_add, sl_free, sl_find – stringlist manipulation functions

Standard C Library (libc, -lc)

#include <stringlist.h>

StringList *

sl_init();

int

sl_add(StringList *sl, char *item);

void

sl_free(StringList *sl, int freeall);

char *

sl_find(StringList *sl, const char *item);

The stringlist functions manipulate stringlists, which are lists of strings that extend automatically if necessary.

The StringList structure has the following definition:

typedef struct _stringlist {
	char	**sl_str;
	size_t	  sl_max;
	size_t	  sl_cur;
} StringList;

The following stringlist manipulation functions are available:

sl_init(): Create a stringlist. Returns a pointer to a StringList, or NULL in case of failure.
sl_free(): Releases memory occupied by sl and the sl->sl_str array. If freeall is non-zero, then each of the items within sl->sl_str is released as well.
sl_add(): Add item to sl->sl_str at sl->sl_cur, extending the size of sl->sl_str. Returns zero upon success, -1 upon failure.
sl_find(): Find item in sl, returning NULL if it is not found.

The stringlist functions appeared in FreeBSD 2.2.6 and NetBSD 1.3.