Query: sl_add
OS: netbsd
Section: 3
Links: netbsd man pages all man pages
Forums: forum home forum categories
Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar
STRINGLIST(3) BSD Library Functions Manual STRINGLIST(3)NAMEstringlist, sl_init, sl_add, sl_free, sl_find, sl_delete -- stringlist manipulation functionsLIBRARYStandard C Library (libc, -lc)SYNOPSIS#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); int sl_delete(StringList *sl, const char *item, int freeit);DESCRIPTIONThe 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; where: sl_str is a pointer to the base of the array containing the list, sl_max is the size of sl_str, and sl_cur is the offset in sl_str of the current element. 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's not found. sl_delete() Remove item from the list. If freeit is non-zero, the string is freed. Returns 0 if the name is found and -1 if the name is not found.SEE ALSOfree(3), malloc(3)HISTORYThe stringlist functions appeared in NetBSD 1.3.BSDMay 6, 2010 BSD