EN JA
STRINGLIST(3)
STRINGLIST(3) FreeBSD Library Functions Manual STRINGLIST(3)

名称

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

ライブラリ

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()
slsl->sl_str 配列によって占有されるメモリを解放します。 freeall が 0 でないなら、 sl->sl_str 内のそれぞれの項目も同様に解放されます。
sl_add()
sl->sl_str のサイズを拡張して、 sl->sl_cursl->sl_stritem を追加します。
sl_find()
slitem を検索し、見つからないなら、NULL を返します。

関連項目

free(3), malloc(3)

歴史

stringlist 関数は、 FreeBSD 2.2.6NetBSD 1.3 で登場しました。
November 28, 1999 FreeBSD