putenv#
Synopsis#
#include <stdlib.h>
int putenv(char *string);
Status#
Partially implemented
Conformance#
IEEE Std 1003.1-2017
Description#
The putenv()
function shall use the string argument to set environment variable values. The string argument should
point to a string of the form “name = value”. The putenv()
function shall make the value of the environment variable
name equal to value by altering an existing variable or creating a new one. In either case, the string pointed to by
string shall become part of the environment, so altering the string shall change the environment.
The putenv()
function need not be thread-safe.
Return value#
Upon successful completion, putenv()
shall return 0
; otherwise, it shall return a non-zero value and set errno
to
indicate the error.
Errors#
The function may fail if:
[
EINVAL
] - The string argument doesn’t contain'='
.[
ENOMEM
] - Insufficient memory was available.
Tests#
Tested
Known bugs#
None