getenv, _wgetenv
從目前的環境取得值。 這些函式已有更安全的版本可用，請參閱 getenv_s、_wgetenv_s。
重要
這個 API 不能用於在 Windows 執行階段中執行的應用程式。 如需詳細資訊，請參閱 CRT functions not supported in Universal Windows Platform apps (通用 Windows 平台應用程式中不支援的 CRT 函式)。
語法
char *getenv(
const char *varname
);
wchar_t *_wgetenv(
const wchar_t *varname
);
參數
varname
環境變數名稱。
傳回值
將指標傳回至包含 varname 的環境資料表項目。 使用傳回的指標修改環境變數的值並不安全。 使用 _putenv 函式修改環境變數的值。 如果varname環境資料表中找不到 ，則傳回值為 NULL 。
備註
getenv 函式會在環境變數清單中搜尋 varname。 getenv 在 Windows 作業系統中不區分大小寫。 getenv 和 _putenv 使用全域變數 _environ 所指出的環境複本來存取環境。 getenv 只會在執行階段程式庫可以存取的資料結構上運作，而不會在作業系統為此處理序所建立的環境「區段」上運作。 因此，使用 envp 自變數的程式mainwmain可能會擷取無效的資訊。
如果 varname 為NULL，則此函式會叫用無效的參數處理程式，如參數驗證中所述。 若允許繼續執行，此函式會將 errno 設為 EINVAL，並傳回 NULL。
_wgetenv 是 getenv 的寬字元版本，_wgetenv 的引數與傳回值是寬字元字串。 _wenviron 全域變數是寬字元版本的 _environ。
在 MBCS 程式中 (例如，在 SBCS ASCII 程式中)，_wenviron 一開始是 NULL，因為此環境由多位元組字元字串所組成。 然後，在第一次呼叫 _wputenv 時，或在第一次呼叫 _wgetenv 時，如果 (MBCS) 環境已經存在，則會建立對應的寬字元字串環境，然後由 _wenviron 指向該變數。
同樣地，在 Unicode (_wmain) 程式中，_environ 一開始是 NULL，因為此環境由寬字元字串所組成。 然後，在第一次呼叫 _putenv 時，或在第一次呼叫 getenv 時，如果 (Unicode) 環境已經存在，則會建立對應的 MBCS 環境，然後再由 _environ 指向該變數。
當此環境的兩個複本 (MBCS 和 Unicode) 在此程式中同時存在時，這個執行階段系統必須同時維護兩份複本，造成執行時間較慢。 例如，每當您呼叫 _putenv 時，也會自動執行對 _wputenv 的呼叫，使得這兩個環境字串對應。
警告
在罕見情況下，當這個執行階段系統正同時維護此環境的 Unicode 版本和多位元組版本時，這兩個環境版本可能無法完全對應。 這是因為雖然任何唯一的多位元組字元字串會對應到唯一的 Unicode 字串，但從唯一的 Unicode 字串對應到多位元組字元字串並不一定唯一。 如需詳細資訊，請參閱 _environ和 _wenviron。
注意
_putenv 和 _getenv 系列的函式不是安全執行緒。 _putenv 正在修改字串時，_getenv 可能會傳回字串指標，因而導致隨機失敗。 確定這些函式的呼叫已同步。
根據預設，此函式的全域狀態會限定於應用程式。 若要變更此行為，請參閱 CRT 中的全域狀態。
一般文字常式對應
TCHAR.H 常式 |
_UNICODE 和 _MBCS 未定義 |
_MBCS 已定義 |
_UNICODE 已定義 |
|---|---|---|---|
_tgetenv |
getenv |
getenv |
_wgetenv |
若要檢查或變更 TZ 環境變數的值，請視需要使用 getenv、_putenv 和 _tzset。 如需 的詳細資訊 TZ，請參閱 _tzset 和 _daylight、 timezone和 _tzname。
需求
| 常式 | 必要的標頭 |
|---|---|
getenv |
<stdlib.h> |
_wgetenv |
<stdlib.h> 或 <wchar.h> |
如需相容性詳細資訊，請參閱相容性。
範例
// crt_getenv.c
// compile with: /W3
// This program uses getenv to retrieve
// the LIB environment variable and then uses
// _putenv to change it to a new value.
#include <stdlib.h>
#include <stdio.h>
int main( void )
{
char *libvar;
// Get the value of the LIB environment variable.
libvar = getenv( "LIB" ); // C4996
// Note: getenv is deprecated; consider using getenv_s instead
if( libvar != NULL )
printf( "Original LIB variable is: %s\n", libvar );
// Attempt to change path. Note that this only affects the environment
// variable of the current process. The command processor's
// environment is not changed.
_putenv( "LIB=c:\\mylib;c:\\yourlib" ); // C4996
// Note: _putenv is deprecated; consider using putenv_s instead
// Get new value.
libvar = getenv( "LIB" ); // C4996
if( libvar != NULL )
printf( "New LIB variable is: %s\n", libvar );
}
Original LIB variable is: C:\progra~1\devstu~1\vc\lib
New LIB variable is: c:\mylib;c:\yourlib