argz_add(3) - wariua/manpages-ko GitHub Wiki

argz_add, argz_add_sep, argz_append, argz_count, argz_create, argz_create_sep, argz_delete, argz_extract, argz_insert, argz_next, argz_replace, argz_stringify - argz 목록을 다루는 함수들

#include <argz.h>

error_t argz_add(char **argz, size_t *argz_len, const char *str);

error_t argz_add_sep(char **argz, size_t *argz_len,
                     const char *str, int delim);

error_t argz_append(char **argz, size_t *argz_len,
                    const char *buf, size_t buf_len);

size_t argz_count(const char *argz, size_t argz_len);

error_t argz_create(char * const argv[], char **argz,
                    size_t *argz_len);

error_t argz_create_sep(const char *str, int sep, char **argz,
                        size_t *argz_len);

void argz_delete(char **argz, size_t *argz_len, char *entry);

void argz_extract(const char *argz, size_t argz_len, char **argv);

error_t argz_insert(char **argz, size_t *argz_len, char *before,
                    const char *entry);

char *argz_next(const char *argz, size_t argz_len, const char *entry);

error_t argz_replace(char **argz, size_t *argz_len, const char *str,
                     const char *with, unsigned int *replace_count);

void argz_stringify(char *argz, size_t len, int sep);

이 함수들은 glibc 전용이다.

argz 벡터는 문자 버퍼에 대한 포인터에 길이가 함께 있는 것이다. 문자 버퍼는 문자열의 배열로 해석하게 되어 있으며 널 바이트('\0')로 그 문자열들을 구분한다. 길이가 0이 아닌 경우 버퍼의 마지막 바이트가 널 바이트여야 한다.

이 함수들은 argz 벡터를 다루기 위한 것이다. (NULL,0) 쌍 역시 argz 벡터이며, 역으로 길이 0인 argz 벡터는 포인터가 널이어야 한다. 비어 있지 않은 argz 벡터를 할당하는 것은 malloc(3)으로 이뤄지며, 따라서 free(3)를 이용해 다시 없앨 수 있다.

argz_add()는 배열 *argz 끝에 문자열 str을 추가하고 *argz와 *argz_len을 갱신한다.

argz_add_sep()도 비슷하되 문자열 str을 구분자 delim으로 나눠지는 하위 문자열들로 쪼갠다. 예를 들어 유닉스 검색 경로에 구분자 ':'로 이 함수를 쓸 수 있을 것이다.

argz_append()는 argz 벡터 (*argz, *argz_len) 뒤에 (buf, buf_len)을 덧붙이고 *argz와 *argz_len을 갱신한다. (그래서 *argz_len이 buf_len만큼 커지게 된다.)

argz_count()는 (argz, argz_len) 내의 문자열 개수, 즉 널 바이트('\0') 개수를 센다.

argz_create()는 (char *) 0으로 끝나는 유닉스 방식 인자 벡터 argv를 argz 벡터 (*argz, *argz_len)으로 변환한다.

argz_create_sep()은 널 종료 문자열 str을 구분자 sep이 있는 모든 곳에서 나눠서 argz 벡터 (*argz, *argz_len)으로 변환한다.

argz_delete()는 argz 벡터 (*argz, *argz_len)에서 entry가 가리키는 하위 문자열을 제거하고 *argz와 *argz_len을 갱신한다.

argz_extract()는 argz_create()의 반대이다. argz 벡터 (argz, argz_len)을 받아서 argv에서 시작하는 배열을 하위 문자열 포인터들과 마지막의 NULL로 채워서 유닉스 방식 argv 벡터를 만든다. 배열 argv에는 포인터 argz_count(argz, argz_len) + 1 개만큼의 공간이 있어야 한다.

argz_insert()는 argz_delete()의 반대이다. argz 벡터 (*argz, *argz_len)의 before 위치에 인자 entry를 끼워 넣고 *argz와 *argz_len을 갱신한다. before가 NULL이면 끝에 entry를 집어넣는다.

argz_next()는 argz 벡터를 순회하기 위한 함수이다. entry가 NULL이면 첫 번째 항목을 반환하고, 아니면 다음 항목을 반환한다. 다음 항목이 없으면 NULL을 반환한다.

argz_replace()는 각 str을 with로 교체하며 필요한 대로 argz를 재할당한다. replace_count가 NULL이 아니면 교체 횟수만큼 *replace_count를 올린다.

argz_stringify()는 argz_create_sep()의 반대이다. 마지막을 뺀 모든 널 바이트('\0')를 sep으로 교체해서 argz 벡터를 보통 문자열로 변환한다.

메모리 할당을 하는 argz 함수들은 모두 반환 타입이 error_t이며, 성공 시 0을 반환하고 할당 오류 발생 시 ENOMEM을 반환한다.

이 절에서 사용하는 용어들에 대한 설명은 attributes(7)를 보라.

이 함수들은 GNU 확장이다. 조심해서 써야 한다.

종료용 널 바이트가 없는 argz 벡터가 세그멘테이션 폴트로 이어질 수 있다.

envz_add(3)

2019-03-06