Man page - envz_remove(3)

Packages contains this manual

Available languages:

en fr es ja ro

Manual

envz_add

NOMBRE
BIBLIOTECA
SINOPSIS
DESCRIPCIÓN
VALOR DEVUELTO
ATRIBUTOS
ESTÁNDARES
EJEMPLOS
VÉASE TAMBIÉN
TRADUCCIÓN

NOMBRE

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

BIBLIOTECA

Biblioteca Estándar C ( libc , -lc )

SINOPSIS

#include <envz.h>

error_t envz_add(char **restrict envz , size_t *restrict envz_len ,
const char *restrict name , const char *restrict value );

char *envz_entry(const char *restrict envz , size_t envz_len ,
const char *restrict name );

char *envz_get(const char *restrict envz , size_t envz_len ,
const char *restrict name );

error_t envz_merge(char **restrict envz , size_t *restrict envz_len ,
const char *restrict envz2 , size_t envz2_len ,
int override );

void envz_remove(char **restrict envz , size_t *restrict envz_len ,
const char *restrict name );

void envz_strip(char **restrict envz , size_t *restrict 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).

Image grohtml-3952047-1.png

ESTÁNDARES

GNU.

EJEMPLOS

#include <envz.h>
#include <stdio.h>
#include <stdlib.h>
int
main(int argc, char *argv[], char *envp[])
{
char *str;
size_t e_len = 0;
for (size_t 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)

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 .