jammy (3) envz_remove.3.gz

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

       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

       All envz functions that do memory allocation have a return type of error_t (an integer type), and  return
       0 for success, and ENOMEM if an allocation error occurs.

ATRIBUTOS

       Para obtener una explicación de los términos usados en esta sección, véase attributes(7).

       ┌────────────────────────────┬────────────────────┬───────────────────┐
       │Interfaz                    │ Atributo           │ Valor             │
       ├────────────────────────────┼────────────────────┼───────────────────┤
       │envz_add(), envz_entry(),   │ Seguridad del hilo │ Multi-hilo seguro │
       │envz_get(), envz_merge(),   │                    │                   │
       │envz_remove(), envz_strip() │                    │                   │
       └────────────────────────────┴────────────────────┴───────────────────┘

CONFORME A

       These functions are a GNU extension.

EJEMPLOS

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

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

           for (int 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);
       }

VÉASE TAMBIÉN

       argz_add(3)

COLOFÓN

       Esta página es parte de la versión 5.10 del proyecto Linux man-pages. Puede encontrar una descripción del
       proyecto,  información  sobre  cómo  informar  errores  y  la  última   versión   de   esta   página   en
       https://www.kernel.org/doc/man-pages/.

TRADUCCIÓN

       La traducción al español de esta página del manual fue creada por Miguel Pérez Ibars <mpi79470@alu.um.es>

       Esta   traducción   es   documentación   libre;   lea   la   GNU   General   Public   License  Version  3
       ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ o posterior con respecto a las condiciones de copyright.   No
       existe NINGUNA RESPONSABILIDAD.

       Si  encuentra  algún  error  en  la  traducción  de esta página del manual, envíe un correo electrónico a
       debian-l10n-spanish@lists.debian.org ⟨⟩.

                                                1 Noviembre 2020                                     ENVZ_ADD(3)