Go to the first, previous, next, last section, table of contents.


putenv

Syntax

#include <stdlib.h>

int putenv(const char *env);

Description

This function adds an entry to the program's environment. The string passed must be of the form NAME=VALUE. Any existing value for the environment variable is gone.

putenv will copy the string passed to it, and will automatically free any existing string already in the environment. Keep this in mind if you alter the environment yourself. The string you pass is still your responsibility to free. Note that most implementations will not let you free the string you pass, resulting in memory leaks.

Return Value

Zero on success, nonzero on failure.

Portability

not ANSI, not POSIX

Example

putenv("SHELL=ksh.exe");


Go to the first, previous, next, last section, table of contents.