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)