60

How do I set an environment variable in C++?

  • They do not need to persist past program execution
  • They only need to be visible in the current process
  • Preference for platform independent but for my problem only needs to work on Win32/64

Thanks

4 Answers 4

65
NAME

       putenv - change or add an environment variable

SYNOPSIS

       #include <stdlib.h>

       int putenv(char *string);

DESCRIPTION
       The  putenv()  function adds or changes the value of environment
       variables.  The argument string is of the form name=value.  If name does
       not already exist in the environment, then string is added  to  the
       environment.   If name does exist, then the value of name in the
       environment is changed to value.  The string pointed to by string becomes
       part of the environment, so altering the string changes the environment.

On Win32 it's called _putenv I believe.

See SetEnvironmentVariable also if you're a fan of long and ugly function names.

14
  • 4
    Note to questioner - putenv is also supported in Win32.
    – anon
    May 22, 2009 at 19:16
  • 38
    Can we please use proper C++ header names? <cstdlib> is appropriate (yeah, I know...it's a hangup of mine). May 22, 2009 at 19:18
  • 5
    It is C as a Lord God intended.
    – alamar
    May 22, 2009 at 19:19
  • 7
    stlib.h is a proper C header file - the question is tagged as C
    – anon
    May 22, 2009 at 19:20
  • 9
    SetEnvironmentVariable is certainly not an ugly function name; it's much more descriptive than putenv.
    – Valentein
    Nov 16, 2011 at 18:52
8

There's also setenv, which is slightly more flexible than putenv, in that setenv checks to see whether the environment variable is already set and won't overwrite it, if you set the "overwrite" argument indicating that you don't want to overwrite it, and also in that the name and value are separate arguments to setenv:

NAME
        setenv - change or add an environment variable
SYNOPSIS
       #include <stdlib.h>

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

       int unsetenv(const char *name);

   Feature Test Macro Requirements for glibc (see feature_test_macros(7)):

       setenv(), unsetenv():
           _POSIX_C_SOURCE >= 200112L
               || /* Glibc versions <= 2.19: */ _BSD_SOURCE
DESCRIPTION
       The setenv() function adds the variable name to the environment with
       the value value, if name does not already exist.  If name does exist
       in the environment, then its value is changed to value if overwrite
       is nonzero; if overwrite is zero, then the value of name is not
       changed (and setenv() returns a success status).  This function makes
       copies of the strings pointed to by name and value (by contrast with
       putenv(3)).

       The unsetenv() function deletes the variable name from the
       environment.  If name does not exist in the environment, then the
       function succeeds, and the environment is unchanged.

I'm not saying either is better or worse than the other; it just depends on your application.

See http://man7.org/linux/man-pages/man3/setenv.3.html

1
  • It is more practical, it avoid to deal with a 'non const' char* as a parameter.
    – 8znr
    Jan 28, 2021 at 17:40
3

I'm not positive environment variables are what you need, since they aren't going to be used outside of this run of the program. No need to engage the OS.

You might be better off having a singleton class or a namespace that holds all these values, and initialize them when you start the program.

2
  • 1
    They will only be visible to child processes, and putenv() usually doesn't need to talk to the OS at all.
    – RBerteig
    May 22, 2009 at 20:23
  • I do not agree with the answer. Sometimes you need to load third party components via DLLs that use environment variables. It is sometimes required to set.
    – AlexF
    Jul 11 at 11:45
0
#include <stdio.h>
#include <unistd.h>
#include <stdlib.h>
#include <string.h>

int main(int argc, char* argv[])
{

    char *var, *value;
    if (argc == 1 || argc > 3) {
        fprintf(stderr, "usage:environ variables \n");
        exit(0);
    }
    var = argv[1];
    value = getenv(var);
    //---------------------------------------
    if (value) {
        printf("variable %s has value %s \n", var, value);
    }
    else
        printf("variable %s has no value \n", var);
    //----------------------------------------
    if (argc == 3) {
        char* string;
        value = argv[2];
        string = malloc(strlen(var) + strlen(value) + 2);
        if (!string) {
            fprintf(stderr, "out of memory \n");
            exit(1);
        }
        strcpy(string, var);
        strcat(string, "=");
        strcat(string, value);
        printf("calling putenv with: %s \n", string);
        if (putenv(string) != 0) {
            fprintf(stderr, "putenv failed\n");
            free(string);
            exit(1);
        }
        value = getenv(var);
        if (value)
            printf("New value of %s is %s \n", var, value);
        else
            printf("New value of %s is null??\n", var);
    }
    exit(0);

} //----main
# commands to execure on linux   
# compile:
$ gcc -o myfile myfile.c

# run:
$./myfile xyz
$./myfile abc
$./myfile pqr
3
  • I expect the answer to consist of (1) an include file and (2) a single line of code. And maybe a library I must link with.
    – notlesh
    Apr 30, 2014 at 19:20
  • 3
    notlesh, why ? Also the compile instructions are right there. Why add more files? I don't get why this is voted down.
    – Owl
    May 25, 2017 at 12:08
  • 3
    It's good practice on Stack Overflow to add an explanation as to why your solution should work. For more information read How To Answer.
    – Samuel Liew
    Apr 11, 2018 at 23:07

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge that you have read and understand our privacy policy and code of conduct.

Not the answer you're looking for? Browse other questions tagged or ask your own question.