Manpages

名 前

setenv − 環 境 変 数 を 変 更 ま た は 追 加 す る

書 式

#include <stdlib.h>

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

int unsetenv(const char *name);

glibc 向 け の 機 能 検 査 マ ク ロ の 要 件 (feature_test_macros(7) 参 照 ):

setenv(), unsetenv():

_BSD_SOURCE || _POSIX_C_SOURCE >= 200112L || _XOPEN_SOURCE >= 600

説 明

setenv() 関 数 は 、 name が 存 在 し な い 場 合 環 境 変 数 name に 値 value を 設 定 し 、 環 境 に 追 加 す る 。 name が 環 境 に 存 在 す る 場 合 、 overwrite が 0 以 外 な ら ば そ の 値 を value に 変 更 し 、 overwrite が 0 な ら ば name の 値 を 変 更 し な い (setenv() は 成 功 の ス テ ー タ ス を 返 す )。 こ の 関 数 は 、 (putenv(3) と 違 い ) name と value に よ り 参 照 さ れ る 文 字 列 の コ ピ ー を 行 う 。

unsetenv() 関 数 は 、 変 数 name を 環 境 か ら 削 除 す る 。 name が 環 境 に な い 場 合 、 こ の 関 数 は 成 功 し 、 環 境 は 変 更 さ れ な い 。

返 り 値

setenv() 関 数 は 、 成 功 す る と 0 を 返 す 。 エ ラ ー の 場 合 、 −1 を 返 し 、 errno に エ ラ ー の 原 因 を 示 す 値 が セ ッ ト さ れ る 。

unsetenv() 関 数 は 、 成 功 す る と 0 を 返 す 。 エ ラ ー の 場 合 は −1 を 返 し 、 errno を 設 定 し て エ ラ ー の 原 因 を 示 す 。

エ ラ ー

環 境 に 新 し い 変 数 を 追 加 す る の に 十 分 な メ モ リ ー が な い 。