getenv-c和c++标准函数

C&C++标准库

getenv

函数 <cstdlib>

char* getenv (const char* name);

获得环境变量字符串

检索包含环境变量的值的c字符串，该环境变量的名称作为参数指定。如果被请求的变量不是环境列表的一部分，函数将返回一个空指针。

指针返回指向一个内部内存块，它的内容或有效性可以通过进一步调用getenv(但不能被其他库函数)改变。

该函数返回的指针所指向的字符串不能被程序修改。一些系统和库实现可能允许用特定的函数改变环境变量(putenv, setenv…)，但这种功能是不可移植的。

☲ 参数

name
c字符串，包含被请求变量的名称。
根据平台的不同，这可能是区分大小写的。

☉ 返回值

带有所请求的环境变量值的c字符串，或者如果不存在这样的环境变量，则使用空指针。

☣ 示例

/* getenv example: getting path */
#include <stdio.h>      /* printf */
#include <stdlib.h>     /* getenv */

int main ()
{
  char* pPath;
  pPath = getenv ("PATH");
  if (pPath!=NULL)
    printf ("The current path is: %s",pPath);
  return 0;
}

上面的示例打印PATH环境变量(如果宿主环境中存在这样的变量).

↭ 数据竞争

同时调用这个函数是安全的，前提是环境保持不变。

❆ 异常(c++)

无抛出保证:此函数从不抛出异常。

🍄 另请参阅

system

执行系统命令(function )