:man| Alphabetical   Categories   About us 
 
STRINGLIST (3) | C library functions | Unix Manual Pages | :man

NAME

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

CONTENTS

Library
Synopsis
Description
See Also
History

LIBRARY


.Lb libc

SYNOPSIS


.In stringlist.h StringList * sl_init int sl_add "StringList *sl" "char *item" void sl_free "StringList *sl" "int freeall" char * sl_find "StringList *sl" "char *item"

DESCRIPTION

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

The
.Vt StringList structure has the following definition:
typedef struct _stringlist {
char **sl_str;
size_t sl_max;
size_t sl_cur;
} StringList;

sl_str a pointer to the base of the array containing the list.
sl_max the size of sl_str.
sl_cur 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
.Vt 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.

SEE ALSO

free(3), malloc(3)

HISTORY


Share this page

     Follow us

Facebook Twitter Google+ LinkedIn


 
Created by Blin Media, 2008-2013