subrutina getenv
Finalidad
Devuelve el valor de una variable de entorno.
Biblioteca
Biblioteca C estándar (libc.a)
Sintaxis
#include <stdlib.h>const char *Name;
Descripción
La subrutina getenv busca en la lista de entornos una serie con el formato Nombre=Valor. Las variables de entorno a veces se denominan variables de shell porque se establecen con frecuencia con mandatos de shell.
Parámetros
| Elemento | Descripción |
|---|---|
| Nombre | Especifica el nombre de una variable de entorno. Si una serie con el formato adecuado no está presente en el entorno actual, la subrutina getenv devuelve un puntero nulo. |
Valores de retorno
La subrutina getenv devuelve un puntero al valor en el entorno actual, si dicha serie está presente. Si dicha serie no está presente, se devuelve un puntero nulo. La subrutina getenv normalmente no modifica la serie devuelta. Sin embargo, la subrutina putenv puede sobrescribir o cambiar la serie devuelta. No intente liberar el puntero devuelto. La subrutina getenv devuelve un puntero a la copia del usuario del entorno (que es estático), hasta la primera invocación de la subrutina putenv que añade una nueva variable de entorno. La subrutina putenv asigna un área de memoria lo suficientemente grande como para contener el entorno del usuario y la nueva variable. La siguiente llamada a la subrutina getenv devuelve un puntero a este espacio recién asignado que no es estático. Las llamadas posteriores de la subrutina putenv utilizan la subrutina realloc para crear espacio para nuevas variables. La finalización no satisfactoria devuelve un puntero nulo.