Content-type: text/html Man page of getenv

getenv

Section: C Library Functions (3)
Index Return to Main Contents
 

NAME

getenv - Returns the value of an environment variable  

LIBRARY

Standard C Library (libc.so, libc.a)  

SYNOPSIS

#include <stdlib.h>

char *getenv(
        const char *name);  

STANDARDS

Interfaces documented on this reference page conform to industry standards as follows:

getenv():  XPG4, XPG4-UNIX

Refer to the standards(5) reference page for more information about industry standards and associated tags.  

PARAMETERS

Specifies the name of an environment variable.  

DESCRIPTION

The getenv() function searches the environment list for a string of the form name=value, and returns a pointer to a string containing the corresponding value for name.

The returned string should not be modified by the application, but may be overwritten by a subsequent call to the getenv() or putenv() functions.  

RETURN VALUES

The getenv() function returns a pointer to a string containing the value in the current environment if such a string is present. If such a string is not present, a null pointer is returned.  

RELATED INFORMATION

Functions: putenv(3), clearenv(3)

Commands: sh(1)

Standards: standards(5) delim off


 

Index

NAME
LIBRARY
SYNOPSIS
STANDARDS
PARAMETERS
DESCRIPTION
RETURN VALUES
RELATED INFORMATION

This document was created by man2html, using the manual pages.
Time: 02:42:06 GMT, October 02, 2010