STRINGLIST(3) | FreeBSD Library Functions Manual | STRINGLIST(3) |
名称
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 を返します。
歴史
stringlist 関数は、 FreeBSD 2.2.6 と NetBSD 1.3 で登場しました。November 28, 1999 | FreeBSD |