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

See Also

  1. Standard library functions
  2. Table of Contents