putenv 子例程

在线编辑

用途

设置环境变量。

库

标准 C 库 (libc.a)

语法

int putenv ( String)
char *String;

描述

注意如果子程序向putenv子程序传递一个指向自动变量的指针，然后返回，而该变量仍是环境的一部分，则可能出现无法预测的结果。

putenv子程序通过修改现有变量或创建新变量来设置环境变量的值。 参数 "字符串指向一个形式为 "名称=价值"的字符串，其中 "名称是环境变量，"价值是环境变量的新值。

字符串参数指向的内存空间会成为环境的一部分，因此更改字符串会有效地改变环境的一部分。 再次调用putenv子程序更改环境变量的值后，就不再使用空格了。 此外，调用putenv子程序后，环境变量不一定按字母顺序排列。

putenv子程序操作environ外部变量，可与getenv子程序结合使用。 但是，作为主子程序第三个参数的EnvironmentPointer参数并没有改变。

putenv子程序使用malloc子程序来扩大环境。

参数

项 描述
String 指向 Name=Value 字符串的指针。

返回值

成功完成后，将返回值 0。 如果malloc子程序无法获得足够的空间来扩展环境，那么putenv子程序就会返回一个非零值。