Provided by: manpages-es_1.55-3_all bug

NOMBRE

       envz_add,  envz_entry,  envz_get, envz_merge, envz_remove, envz_strip -
       soporte para las cadenas de entorno

SINOPSIS

       #include <envz.h>

       error_t
       envz_add(char **envz, size_t *envz_len,
                const char *nombre, const char *valor);

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

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

       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 *nombre);

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

DESCRIPCIÓN

       Estas funciones son específicas de glibc.

       Un vector argz es un puntero a un buffer de caracteres  junto  con  una
       longitud,  véase  argz_add(3).   Un  vector  envz  es  un  vector  argz
       especial, donde las cadenas son de la forma "nombre=valor". Todo lo que
       sigue  al primer ’=’ se considera el valor.  Si no hay un carácter ’=’,
       el valor se considera NULL.  (Mientras que el valor en el caso  en  que
       haya un ’=’ al final es la cadena vacía "".)

       Estas funciones se usan para manejar vectores envz.

       envz_add()  añade la cadena "nombre=valor" (en el caso en que valor sea
       distinto de NULL) o "nombre" (en el caso en  que  valor  sea  NULL)  al
       vector  envz  (*envz,*envz_len)  y  actualiza *envz y *envz_len.  Si ya
       existe una entrada con el mismo nombre , se elimina.

       envz_entry() busca el  nombre  en  el  vector  envz  (envz,envz_len)  y
       devuelve la entrada si se encuentra, o NULL en caso contrario.

       envz_get() busca el nombre en el vector envz (envz,envz_len) y devuelve
       el valor si se encuentra, o NULL en caso contrario.   (Observe  que  el
       valor  también  puede  ser NULL, este caso se da cuando hay una entrada
       para nombre sin el carácter ’=’.)

       envz_merge() añada cada entrada en envz2 a *envz, de  la  misma  manera
       que  envz_add().   Si  override  es  verdadero,  los  valores  de envz2
       reemplazarán aquellos con el mismo nombre en *envz.

       envz_remove() elimina la entrada para nombre  de  (*envz,*envz_len)  si
       existe una.

       envz_strip elimina todas las entradas con valor NULL.

VALOR DEVUELTO

       Todas  las  funciones envz que realizan reserva de memoria devuelven un
       tipo error_t, y devuelven 0 en caso de éxito, y  ENOMEM  si  ocurre  un
       error con la asignación de memoria.

EJEMPLO

       #include <stdio.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);
            return 0;
       }

OBSERVACIONES

       Estas funciones son extensiones de GNU. Manéjelas con cuidado.

VÉASE TAMBIÉN

       argz(3)

                                                                   ENVZ_ADD(3)