名称

stringlist, sl_init, sl_add, sl_free, sl_find — stringlist (文字列リスト) 操作関数

ライブラリ

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);

解説

stringlist 関数は、必要ならば、自動的に展開する文字列のリストである stringlist (文字列リスト) を操作します。

StringList 構造体は、次の定義となっています:

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

sl_str

リストを含んでいる配列の基底へのポインタです。

sl_max

sl_str のサイズ。

sl_cur

現在の要素の sl_str のオフセット。

次の stringlist 操作関数が利用可能です:

sl_init()

stringlist を作成します。 StringList へのポインタ返し、失敗した場合に、 NULL 返します。

sl_free()

sl と sl->sl_str 配列によって占有されるメモリを解放します。 freeall が 0 でないなら、 sl->sl_str 内のそれぞれの項目も同様に解放されます。

sl_add()

sl->sl_str のサイズを拡張して、 sl->sl_cur の sl->sl_str に item を追加します。

sl_find()

sl の item を検索し、見つからないなら、NULL を返します。

関連項目

free(3), malloc(3)

歴史

stringlist 関数は、 FreeBSD 2.2.6 と NetBSD 1.3 で登場しました。