STRINGLIST(3)

명칭
stringlist, sl_init, sl_add, sl_free, sl_find - 캐릭터 라인 리스트 조작 함수

프로그램 라이브러리
libc

서식
<stringlist.h> StringList * sl_init() void sl_add(StringList *sl, char *item) void sl_free(StringList *sl, int freeall) char * sl_find(StringList *sl, char *item)

해설
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 에 있어서의 오프셋(offset).

이하와 같은 캐릭터 라인 리스트 조작 함수를 사용할 수 있습니다 :

sl_init()
    캐릭터 라인 리스트를 작성합니다. StringList 에의 포인터를 돌려줍니다.

sl_free()
    sl 및 sl->sl_str 배열이 점유 하는 메모리를 해방합니다. freeall 하지만 비 0 의 경우는, sl->sl_str 안의 항목도 해방됩니다.

sl_add()
    sl->sl_str 의 사이즈를 확장해, item (을)를 sl->sl_str 의 sl->sl_cur 의 위치에 추가합니다.

sl_find()
    sl 안의 item (을)를 찾아, 발견되지 않는 경우는 NULL 를 돌려줍니다.

참조
free(3), malloc(3)