table of contents
- bullseye 4.10.0-1
- bullseye-backports 4.17.0-2~bpo11+1
ENVZ_ADD(3) | Manual del Programador de Linux | ENVZ_ADD(3) |
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(), envz_get(), envz_merge(), envz_remove(), envz_strip() | Seguridad del hilo | Multi-hilo seguro |
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¶
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 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 |