getenv#
Synopsis#
#include <stdlib.h>
int getenv(const char *name);
Status#
Partially implemented
Conformance#
IEEE Std 1003.1-2017
Description#
The getenv()
function shall search the environment of the calling process (see XBD Environment Variables) for the
environment variable name if it exists and return a pointer to the value of the environment variable. If the specified
environment variable cannot be found, a null pointer shall be returned. The application shall ensure that it does not
modify the string pointed to by the getenv()
function.
The returned string pointer might be invalidated, or the string content might be overwritten by a subsequent call to
getenv()
,setenv()
,unsetenv()
, or putenv()
, but they shall not be affected by a call to any other function in
this volume of POSIX.1-2017
.
Return value#
Upon successful completion, getenv()
shall return a pointer to a string containing the value for the specified name.
If the specified name cannot be found in the environment of the calling process, a null pointer shall be returned.
Errors#
No errors are defined.
Tests#
Tested
Known bugs#
None