setenv() -- set environment variable

SYNOPSIS

#include <stdlib.h>

int setenv(const char *name, const char *value, int rewrite);

The setenv() function sets an environment variable pointed to by name with the value pointed to by value. If the variable already exists in the environment and rewrite is set, it is overwritten.

PARAMETERS

name: Points to the name of an environment variable
value: Points to the value to be assigned to the environment variable.
rewrite: Replaces the value of the current variable.

RETURN VALUES

The setenv() function returns non-zero if it was unable to obtain enough space using malloc() for an expanded environment, or if the environment variable already exists and the rewrite is not set. Otherwise, it returns zero.