putenv

Section: C Library Functions (3)
Updated: 2026-02-08
Index JM Home Page roff page
 

名前

putenv - 環境変数の変更または追加  

ライブラリ

標準 C ライブラリ (libc,~-lc)  

書式

#include <stdlib.h>


int putenv(char *string);

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

putenv():

    _XOPEN_SOURCE
        || /* glibc >= 2.19: */ _DEFAULT_SOURCE
        || /* glibc <= 2.19: */ _SVID_SOURCE
 

説明

putenv() 関数は、環境変数の追加または値の変更を行う。 引数 string は name=value という形式を取る。 name が環境に存在しない場合は string が環境に追加される。 name が環境に存在する場合は name の値は value に変更される。 string が指している文字列は環境の一部となるので、 文字列を変更すると環境も変更される。  

返り値

The putenv() function returns zero on success. On failure, it returns a nonzero value, and errno is set to indicate the error.  

エラー

ENOMEM
新しい環境を割り当てるのに十分な空きがない。
 

属性

この節で使用されている用語の説明については、 attributes(7) を参照。
インターフェース属性値
putenv() Thread safetyMT-Unsafe const:env
 

標準規格

POSIX.1-2008.  

歴史

POSIX.1-2001, SVr2, 4.3BSD-Reno.

putenv() はリエントラントであることを求められていない。 glibc 2.0 ではリエントラントではない。 glibc 2.1 ではリエントラントである。

Since glibc 2.1.2, the glibc implementation conforms to SUSv2: the pointer string given to putenv() is used. In particular, this string becomes part of the environment; changing it later will change the environment. (Thus, it is an error to call putenv() with an automatic variable as the argument, then return from the calling function while string is still part of the environment.) However, from glibc 2.0 to glibc 2.1.1, it differs: a copy of the string is used. On the one hand this causes a memory leak, and on the other hand it violates SUSv2.

The 4.3BSD-Reno version, like glibc 2.0, uses a copy; this is fixed in all modern BSDs.

SUSv2 ではプロトタイプから const が取り除かれており、 glibc 2.1.3 もそのようになっている。

The GNU C library implementation provides a nonstandard extension. If string does not include an equal sign:

putenv("NAME");

then the named variable is removed from the caller's environment.  

関連項目

clearenv(3), getenv(3), setenv(3), unsetenv(3), environ(7)


 

Index

名前
ライブラリ
書式
説明
返り値
エラー
属性
標準規格
歴史
関連項目

This document was created by man2html, using the manual pages.