Linux Certif

Toute la documentation sur la certification Linux LPI

envz_add

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)