C 標準関数逆引き辞典

char *getenv(const char *v)

システムに設定されている環境変数の値を文字列で取得します。 取得できる環境変数は、プログラムを実行するユーザによって異なります。

指定した環境変数が見つかった場合は、その値へのポインタを返します。 指定した環境変数が見つからなかった場合は、NULL を返します。

●引数

v … 環境変数の名前

●戻り値

・環境変数が見つかった … その値へのポインタ
・環境変数が見つからなかった … NULL

●補足

Windows ではアルファベットの大文字と小文字を区別しませんが、Unix/Linux では区別します。

例えば USERNAME という環境変数があった場合、username を指定すると Unix/Linux では値を取得できません。

USERNAME=Watabe

char *env;

env = getenv("username");

ソースファイル

env は Windows で "Watabe" 、Unix/Linux で NULL になります。

●重要

返されたポインタを使って環境変数の値を変更するのは危険です。
プログラムの動作は保障できません。

OS によっては、環境変数の値を変更できる関数が存在しますので、そちらを使うようにします。

なお、環境変数の値を変更する関数は ANSI C に定義されていません。
そのため、環境変数の値を変更する関数については割愛します。