共用方式為


_environ, _wenviron

_environ 變數是指標,指向多位元組字元字串之指標的陣列,而該字串構成此處理序環境。 這個全域變數已被取代為更安全的功能版本 getenv_s_wgetenv_s_putenv_s_wputenv_s應該用來取代全域變數。 _environ 在 Stdlib.h 中宣告。

重要

這個 API 不能用於在 Windows 執行階段中執行的應用程式。 如需詳細資訊,請參閱 CRT functions not supported in Universal Windows Platform apps (通用 Windows 平台應用程式中不支援的 CRT 函式)。

語法

extern char **_environ;

備註

在使用 main 函式的程式中,根據作業系統環境上擷取的設定,會在程式啟動時初始化 _environ。 此環境包含該形式的一或多個項目。

ENVVARNAME =string

getenv_sputenv_s 使用 _environ 變數來存取和修改環境資料表。 在呼叫 _putenv 以加入或刪除環境設定時,此環境資料表會變更大小。 其在記憶體中的位置也可能會變更,視程式的記憶體需求而定。 _environ 的值會自動隨之調整。

_wenviron 變數,在 Stdlib.h 中宣告如下:

extern wchar_t **_wenviron;

這是 _environ 的寬字元版本。 在使用 wmain 函式的程式中,根據作業系統環境上擷取的設定,會在程式啟動時初始化 _wenviron

在使用 main 的程式中,_wenviron 一開始是 NULL,因為此環境由多位元組字元字串所組成。 在對於 _wgetenv_wputenv 的第一次呼叫時,會由 _wenviron 建立對應的寬字元字串環境並指向此環境。

同樣地,在使用 wmain 的程式中,_environ 一開始是 NULL,因為此環境由寬字元字串所組成。 在對於 _getenv_putenv 的第一次呼叫時,會由 _environ 建立對應的多位元組字元字串環境並指向此環境。

當此環境的兩個複本 (MBCS 和 Unicode) 在此程式中同時存在時,這個執行階段系統必須同時維護兩份複本,造成執行時間較慢。 例如,每當您呼叫 _putenv 時,也會自動執行對 _wputenv 的呼叫,使得這兩個環境字串對應。

警告

在罕見情況下,當這個執行階段系統正同時維護此環境的 Unicode 版本和多位元組版本時,這兩個環境版本可能無法完全對應。 這是因為雖然任何唯一的多位元組字元字串會對應到唯一的 Unicode 字串,但從唯一的 Unicode 字串對應到多位元組字元字串並不一定唯一。 因此,兩個不同的 Unicode 字串可能對應至相同的多位元組字串。

當使用 /MD/MDd 連結時,在 Unicode 內容中輪詢 _environ 是無意義的。 對於此 CRT DLL,該程式的類型 (寬或多位元組) 是未知的。 因為多位元組類型最可能的情節,所以只建立多位元組類型。

下列虛擬程式代碼說明如何建立此作業。

int i, j;
i = _wputenv( "env_var_x=string1" );  // results in the implicit call:
                                      // putenv ("env_var_z=string1")
j = _wputenv( "env_var_y=string2" );  // also results in implicit call:
                                      // putenv("env_var_z=string2")

在此範例所使用的表示法中,字元字串不是 C 字串常值;相反地,它們是佔位元,代表呼叫中的 _wputenv Unicode 環境字串常值,以及呼叫中的 putenv 多位元組環境字串。 兩個相異 Unicode 環境字串中的字元佔位元 'x' 和 'y' 不會唯一對應至目前 MBCS 中的字元。 相反地,這兩種都會對應至某個 MBCS 字元 'z',此為嘗試轉換該字串的預設結果。

因此,在多位元組環境中,在第一次對 putenv 的隱含呼叫後,"env_var_z" 的值可能是 "string1",但是當 "env_var_z" 的值設定為 "string2" 時,可能會在第二次對 putenv 的隱含呼叫時覆寫這個值。 因此 Unicode 環境 (在 _wenviron 中) 和多位元組環境 (在 _environ 中) 可能會在這一系列的呼叫後有所不同。

另請參閱

全域變數
getenv, _wgetenv
getenv_s, _wgetenv_s
_putenv, _wputenv
_putenv_s, _wputenv_s