# QProcessEnvironment Class Reference ## [[QtCore](index.htm) module] 該QProcessEnvironment類認為可以傳遞給一個程序的環境變量。[More...](#details) ### Methods * `__init__ (self)` * `__init__ (self, QProcessEnvironment?other)` * `clear (self)` * `bool contains (self, QString?name)` * `insert (self, QString?name, QString?value)` * `insert (self, QProcessEnvironment?e)` * `bool isEmpty (self)` * `QStringList keys (self)` * `remove (self, QString?name)` * `QStringList toStringList (self)` * `QString value (self, QString?name, QString?defaultValue?=?QString())` ### Static Methods * `QProcessEnvironment systemEnvironment ()` ### Special Methods * `bool __eq__ (self, QProcessEnvironment?other)` * `bool __ne__ (self, QProcessEnvironment?other)` * * * ## Detailed Description 該QProcessEnvironment類認為可以傳遞給一個程序的環境變量。 一個進程的環境是由一組被稱為環境變量key = value對的。該QProcessEnvironment類包裝的概念，并可以方便地操縱這些變量。它的意思也可以一起使用[QProcess](qprocess.html)，設置為子進程的環境。它不能被用于改變當前進程的環境。 可以用以下方式獲得的調用進程的環境[QProcessEnvironment.systemEnvironment](qprocessenvironment.html#systemEnvironment)（ ） 。 在Unix系統中，變量名稱是區分大小寫的。出于這個原因，這個類不會接觸到變量的名稱。還要注意的Unix環境允許兩個變量名和內容，包含任意的二進制數據（除NUL字符），但是這是不支持QProcessEnvironment 。這個類只支持名稱和可編碼是由當前區域設置（見QTextCodec.codecForLocale ）值。 在Windows中，變量名是大小寫不敏感的。因此， QProcessEnvironment總是大寫的名字，做不區分大小寫的比較。 在Windows CE上，環境的概念并不存在。這個類將保持與其他平臺之間的兼容性設置的值，但設置的值將不會對正在創建的過程沒有影響。 * * * ## Method Documentation ``` QProcessEnvironment.__init__ (self) ``` 創建一個新的[QProcessEnvironment](qprocessenvironment.html)對象。此構造函數創建一個空的環境。如果在設置[QProcess](qprocess.html)，這將導致當前的環境變量被刪除。 ``` QProcessEnvironment.__init__ (self, QProcessEnvironment?other) ``` 創建[QProcessEnvironment](qprocessenvironment.html)對象，它是一個拷貝_other_。 ``` QProcessEnvironment.clear (self) ``` 移除所有這一切key = value對[QProcessEnvironment](qprocessenvironment.html)對象，使之為空。 **See also** [isEmpty](qprocessenvironment.html#isEmpty)（）和[systemEnvironment](qprocessenvironment.html#systemEnvironment)（ ） 。 ``` bool QProcessEnvironment.contains (self, QString?name) ``` 返回True如果name環境變量_name_在這個被發現[QProcessEnvironment](qprocessenvironment.html)對象。 在Windows中，變量名是大小寫不敏感的，所以關鍵是轉換為大寫搜索之前。在其他系統上，名稱是區分大小寫的，因此沒有改造中的應用。 **See also** [insert](qprocessenvironment.html#insert)（）和[value](qprocessenvironment.html#value)（ ） 。 ``` QProcessEnvironment.insert (self, QString?name, QString?value) ``` 插入名稱的環境變量_name_和內容_value_這個[QProcessEnvironment](qprocessenvironment.html)對象。如果該變量已經存在，它被替換為新值。 在Windows中，變量名是大小寫不敏感的，所以插入之前這個函數總是變大寫變量名。在其他系統上，名稱是區分大小寫的，所以沒有變換應用。 在大多數系統中，沒有內容插入一個變量將有應用，如果該變量沒有被設置在所有相同的效果。然而，為了保證不存在任何不兼容，要刪除一個變量，請使用[remove](qprocessenvironment.html#remove)（）函數。 **See also** [contains](qprocessenvironment.html#contains)（ ）[remove](qprocessenvironment.html#remove)（）和[value](qprocessenvironment.html#value)（ ） 。 ``` QProcessEnvironment.insert (self, QProcessEnvironment?e) ``` 這是一個重載函數。 插入的內容_e_在這[QProcessEnvironment](qprocessenvironment.html)對象。在這個對象的變量，也存在于_e_將被復蓋。 此功能被引入Qt的4.8 。 ``` bool QProcessEnvironment.isEmpty (self) ``` 返回True如果[QProcessEnvironment](qprocessenvironment.html)對象是空的：那就是有沒有設置key = value對。 **See also** [clear](qprocessenvironment.html#clear)（ ）[systemEnvironment](qprocessenvironment.html#systemEnvironment)（）和[insert](qprocessenvironment.html#insert)（ ） 。 ``` QStringList QProcessEnvironment.keys (self) ``` 返回包含在這一切的變數名稱的列表[QProcessEnvironment](qprocessenvironment.html)對象。 此功能被引入Qt的4.8 。 ``` QProcessEnvironment.remove (self, QString?name) ``` 刪除所確定的環境變量_name_由此[QProcessEnvironment](qprocessenvironment.html)對象。如果該變量不存在之前，沒有任何反應。 在Windows中，變量名是大小寫不敏感的，所以關鍵是轉換為大寫搜索之前。在其他系統上，名稱是區分大小寫的，因此沒有改造中的應用。 **See also** [contains](qprocessenvironment.html#contains)（ ）[insert](qprocessenvironment.html#insert)（）和[value](qprocessenvironment.html#value)（ ） 。 ``` QProcessEnvironment QProcessEnvironment.systemEnvironment () ``` [ 該systemEnvironment函數返回調用進程的環境。 ](qprocessenvironment.html) [它返回一個](qprocessenvironment.html)[QProcessEnvironment](qprocessenvironment.html)。這個函數不緩存系統環境。因此，有可能獲得環境的更新版本，如果低級別的C庫函數如`setenv`OT`putenv`已被調用。 但是請注意，重復調用此函數將重新[QProcessEnvironment](qprocessenvironment.html)對象，這是一個非平凡的操作。 此功能被引入Qt的4.6 。 **See also** [QProcess.systemEnvironment](qprocess.html#systemEnvironment)（ ） 。 ``` QStringList QProcessEnvironment.toStringList (self) ``` 這個轉換[QProcessEnvironment](qprocessenvironment.html)對象轉換成字符串，一個用于設置每個環境變量的列表。環境變量的名稱和它的值是由一個平等的字符（' = '）隔開。 該[QStringList](qstringlist.html)此函數返回的內容是適合與QProcess.setEnvironment功能的使用。然而，它是推薦使用QProcess.setProcessEnvironment代替，因為這將避免不必要的數據的復制。 **See also** [systemEnvironment](qprocessenvironment.html#systemEnvironment)（ ）[QProcess.systemEnvironment](qprocess.html#systemEnvironment)（ ）[QProcess.environment](qprocess.html#environment)（）和[QProcess.setEnvironment](qprocess.html#setEnvironment)（ ） 。 ``` QString QProcessEnvironment.value (self, QString?name, QString?defaultValue?=?QString()) ``` 這個搜索[QProcessEnvironment](qprocessenvironment.html)對象，用于確定一個變量_name_并返回它的值。如果在該對象中找到的變量，則_defaultValue_返回來代替。 在Windows中，變量名是大小寫不敏感的，所以關鍵是轉換為大寫搜索之前。在其他系統上，名稱是區分大小寫的，因此沒有改造中的應用。 **See also** [contains](qprocessenvironment.html#contains)（ ）[insert](qprocessenvironment.html#insert)（）和[remove](qprocessenvironment.html#remove)（ ） 。 ``` bool QProcessEnvironment.__eq__ (self, QProcessEnvironment?other) ``` ``` bool QProcessEnvironment.__ne__ (self, QProcessEnvironment?other) ```