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

envz_add, envz_entry, envz_get, envz_merge, envz_remove, envz_strip - 환경 문자열 지원

#include <envz.h>

error_t envz_add(char **envz, size_t *envz_len,
                 const char *name, const char *value);

char *envz_entry(const char *envz, size_t envz_len, const char *name);

char *envz_get(const char *envz, size_t envz_len, const char *name);

error_t envz_merge(char **envz, size_t *envz_len,
                   const char *envz2, size_t envz2_len, int override);

void envz_remove(char **envz, size_t *envz_len, const char *name);

void envz_strip(char **envz, size_t *envz_len);

이 함수들은 glibc 전용이다.

argz 벡터는 문자 버퍼에 대한 포인터에 길이가 함께 있는 것이다. (argz_add(3) 참고.) envz 벡터는 argz 벡터의 특수한 형태로, 문자열들이 "이름=값" 형태로 되어 있다. 첫 번째 '=' 뒤에 있는 것을 모두 값이라고 본다. '='가 없으면 값이 NULL인 것으로 한다. (반면 '='로 끝나는 경우의 값은 빈 문자열 ""이다.)

이 함수들은 envz 벡터를 다루기 위한 것이다.

envz_add()는 envz 벡터 (*envz, *envz_len)에 문자열 "name=value"(value가 NULL이 아닌 경우)나 "name"(value가 NULL인 경우)을 추가하고 *envz와 *envz_len을 갱신한다. name이 같은 항목이 존재하면 제거하고 추가한다.

envz_entry()는 envz 벡터 (envz, envz_len)에서 name을 탐색하며, 찾으면 그 항목을 반환하고 없으면 NULL을 반환한다.

envz_get()은 envz 벡터 (envz, envz_len)에서 name을 탐색하며, 찾으면 그 값을 반환하고 없으면 NULL을 반환한다. (참고로 '=' 없는 name 항목이 있으면 값이 NULL일 수 있다.)

envz_merge()는 envz2의 각 항목을 envz_add()를 쓴 것처럼 *envz에 추가한다. override가 참이면 envz2에 있는 값이 *envz에 있는 같은 이름의 값을 대체하고, 아니면 그러지 않는다.

envz_remove()는 (*envz, *envz_len)에 name 항목이 있으면 제거한다.

envz_strip()은 값이 NULL인 항목을 모두 제거한다.

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

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

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

#include <stdio.h>
#include <stdlib.h>
#include <envz.h>

int
main(int argc, char *argv[], char *envp[])
{
    int i, e_len = 0;
    char *str;

    for (i = 0; envp[i] != NULL; i++)
        e_len += strlen(envp[i]) + 1;

    str = envz_entry(*envp, e_len, "HOME");
    printf("%s\n", str);
    str = envz_get(*envp, e_len, "HOME");
    printf("%s\n", str);
    exit(EXIT_SUCCESS);
}

argz_add(3)

2017-09-15