QHostInfo Class Reference · PyQt4 中文文檔

# QHostInfo Class Reference ## [[QtNetwork](index.htm) module] 該QHostInfo類提供靜態函數為主機名查找。[More...](#details) ### Types * `enum HostInfoError { NoError, HostNotFound, UnknownError }` ### Methods * `__init__ (self, int?id?=?-1)` * `__init__ (self, QHostInfo?d)` * `list-of-QHostAddress addresses (self)` * `HostInfoError error (self)` * `QString errorString (self)` * `QString hostName (self)` * `int lookupId (self)` * `setAddresses (self, list-of-QHostAddress?addresses)` * `setError (self, HostInfoError?error)` * `setErrorString (self, QString?errorString)` * `setHostName (self, QString?name)` * `setLookupId (self, int?id)` ### Static Methods * `abortHostLookup (int?lookupId)` * `QHostInfo fromName (QString?name)` * `QString localDomainName ()` * `QString localHostName ()` * `int lookupHost (QString?name, QObject?receiver, SLOT(QHostInfo)SLOT()?member)` * `int lookupHost (QString?name, callable?receiver)` * * * ## Detailed Description 該QHostInfo類提供靜態函數為主機名查找。 QHostInfo使用提供的操作系統找到一個主機名，或與IP地址對應的主機名相關的IP地址（ ES ）的查找機制。這個類提供了兩個靜態的便利功能：一個以異步方式工作，并發出信號，一旦主機被發現，而另一個塊，并返回一個QHostInfo對象。要查找主機的IP地址異步調用[lookupHost](qhostinfo.html#lookupHost)（），這需要主機名或IP地址，接收對象和槽簽名作為參數并返回一個ID 。你可以通過調用中止查詢[abortHostLookup](qhostinfo.html#abortHostLookup)（）與查找的ID 。例如： ``` // To find the IP address of qt.nokia.com QHostInfo.lookupHost("qt.nokia.com", this, SLOT(printResults(QHostInfo))); // To find the host name for 4.2.2.1 QHostInfo.lookupHost("4.2.2.1", this, SLOT(printResults(QHostInfo))); ``` 該槽被調用時，結果準備就緒。結果被存儲在一個QHostInfo對象。通話[addresses](qhostinfo.html#addresses)（）來獲得主機的IP地址列表，并[hostName](qhostinfo.html#hostName)（）來獲取被查找的主機名。如果查找失敗，[error](qhostinfo.html#error)（）返回發生錯誤的類型。[errorString](qhostinfo.html#errorString)（）給出了查找錯誤的人類可讀的描述。如果你想有一個阻塞的查找，使用[QHostInfo.fromName](qhostinfo.html#fromName)（）函數： ``` QHostInfo info = QHostInfo.fromName("qt.nokia.com"); ``` QHostInfo支持國際化域名（IDN ）通過IDNA和Punycode的標準。檢索本地主機的名稱，使用靜態[QHostInfo.localHostName](qhostinfo.html#localHostName)（）函數。 **Note:**由于Qt的4.6.1 QHostInfo使用多線程進行DNS查詢，而不是一個專用的DNS線程。這提高了性能，而且還當使用改變信號的排放順序[lookupHost](qhostinfo.html#lookupHost)（）相比， Qt之前版本。**Note:**由于Qt的4.6.3 QHostInfo使用以提高性能，一個小的內部60秒DNS緩存。 * * * ## Type Documentation ``` QHostInfo.HostInfoError ``` 這個枚舉描述試圖解析主機名時可能出現的各種錯誤。 | Constant | Value | Description | | --- | --- | --- | | `QHostInfo.NoError` | `0` | 該查找是成功的。 | | `QHostInfo.HostNotFound` | `1` | 未找到主機沒有IP地址。 | | `QHostInfo.UnknownError` | `2` | 發生未知錯誤。 | **See also** [error](qhostinfo.html#error)（）和[setError](qhostinfo.html#setError)（）。 * * * ## Method Documentation ``` QHostInfo.__init__ (self, int?id?=?-1) ``` 構造一個空的主機信息對象查找的ID_id_。 **See also** [lookupId](qhostinfo.html#lookupId)（）。 ``` QHostInfo.__init__ (self, QHostInfo?d) ``` 構造的副本_other_。 ``` QHostInfo.abortHostLookup (int?lookupId) ``` 中止主機查找的ID_id_，所返回的[lookupHost](qhostinfo.html#lookupHost)（）。 **See also** [lookupHost](qhostinfo.html#lookupHost)（）和[lookupId](qhostinfo.html#lookupId)（）。 ``` list-of-QHostAddress QHostInfo.addresses (self) ``` 返回與關聯的IP地址列表[hostName](qhostinfo.html#hostName)（）。這個列表可能是空的。例如： ``` [QHostInfo](qhostinfo.html) info; ... if (!info.addresses().isEmpty()) { [QHostAddress](qhostaddress.html) address = info.addresses().first(); // use the first IP address } ``` **See also** [setAddresses](qhostinfo.html#setAddresses)（）[hostName](qhostinfo.html#hostName)（）和[error](qhostinfo.html#error)（）。 ``` HostInfoError QHostInfo.error (self) ``` [](qhostinfo.html#HostInfoError-enum) [返回，如果主機名查找失敗時發生錯誤的類型，否則返回](qhostinfo.html#HostInfoError-enum)[NoError](qhostinfo.html#HostInfoError-enum)。 **See also** [setError](qhostinfo.html#setError)（）和[errorString](qhostinfo.html#errorString)（）。 ``` QString QHostInfo.errorString (self) ``` 如果查找失敗，則此函數返回錯誤的人類可讀的描述;否則返回“未知錯誤” 。 **See also** [setErrorString](qhostinfo.html#setErrorString)（）和[error](qhostinfo.html#error)（）。 ``` QHostInfo QHostInfo.fromName (QString?name) ``` [](qhostinfo.html) [對于給定的主機查找IP地址（ ES ）_name_。查找這意味著在程序執行過程中的功能塊被掛起，直到查找的結果是準備好了。返回在該查詢的結果](qhostinfo.html)[QHostInfo](qhostinfo.html)對象。如果你傳遞一個文字IP地址_name_而不是一個主機名，[QHostInfo](qhostinfo.html)將搜索的域名為IP （即，[QHostInfo](qhostinfo.html)將執行_reverse_查找）。如果成功，則返回[QHostInfo](qhostinfo.html)將包含解析域名和IP地址的主機名。 **See also** [lookupHost](qhostinfo.html#lookupHost)（）。 ``` QString QHostInfo.hostName (self) ``` 返回主機的IP地址進行查找時的名稱。 **See also** [setHostName](qhostinfo.html#setHostName)（）和[localHostName](qhostinfo.html#localHostName)（）。 ``` QString QHostInfo.localDomainName () ``` 返回本機的DNS域。注： DNS域是不相關的，在Windows網絡中存在的域名。 **See also** [hostName](qhostinfo.html#hostName)（）。 ``` QString QHostInfo.localHostName () ``` 返回本機的主機名。 **See also** [hostName](qhostinfo.html#hostName)（）。 ``` int QHostInfo.lookupHost (QString?name, QObject?receiver, SLOT(QHostInfo)SLOT()?member) ``` 查找與主機名相關的IP地址（ ES ）_name_，并返回查找的ID。當查找的結果是準備好了，槽或信號_member_在_receiver_被稱為一個[QHostInfo](qhostinfo.html)的說法。該[QHostInfo](qhostinfo.html)對象可以被檢查，以得到該查找的結果。該查找是一個函數調用，例如執行： ``` [QHostInfo](qhostinfo.html).lookupHost("www.kde.org", this, SLOT(lookedUp([QHostInfo](qhostinfo.html)))); ``` 槽的實施打印有關的查詢返回的地址的基本信息，或報告，如果它失敗的錯誤： ``` void MyWidget.lookedUp(const [QHostInfo](qhostinfo.html) &host) { if (host.error() != [QHostInfo](qhostinfo.html).NoError) { qDebug() << "Lookup failed:" << host.errorString(); return; } foreach (const [QHostAddress](qhostaddress.html) &address, host.addresses()) qDebug() << "Found address:" << address.toString(); } ``` 如果你傳遞一個文字IP地址_name_而不是一個主機名，[QHostInfo](qhostinfo.html)將搜索的域名為IP （即，[QHostInfo](qhostinfo.html)將執行_reverse_查找）。上的成功，將所得[QHostInfo](qhostinfo.html)將包含解析域名和IP地址的主機名。例如： ``` [QHostInfo](qhostinfo.html).lookupHost("4.2.2.1", this, SLOT(lookedUp([QHostInfo](qhostinfo.html)))); ``` **Note:**有沒有保證，如果你開始的多個請求與lookupHost （）的信號將被發出的順序。 **See also** [abortHostLookup](qhostinfo.html#abortHostLookup)（）[addresses](qhostinfo.html#addresses)（）[error](qhostinfo.html#error)（）和[fromName](qhostinfo.html#fromName)（）。 ``` int QHostInfo.lookupHost (QString?name, callable?receiver) ``` ``` int QHostInfo.lookupId (self) ``` 返回此查詢的ID 。 **See also** [setLookupId](qhostinfo.html#setLookupId)（）[abortHostLookup](qhostinfo.html#abortHostLookup)（）和[hostName](qhostinfo.html#hostName)（）。 ``` QHostInfo.setAddresses (self, list-of-QHostAddress?addresses) ``` 設置在該地址列表[QHostInfo](qhostinfo.html)至_addresses_。 **See also** [addresses](qhostinfo.html#addresses)（）。 ``` QHostInfo.setError (self, HostInfoError?error) ``` 設置這種錯誤類型[QHostInfo](qhostinfo.html)至_error_。 **See also** [error](qhostinfo.html#error)（）和[errorString](qhostinfo.html#errorString)（）。 ``` QHostInfo.setErrorString (self, QString?errorString) ``` 設置錯誤的發生，以人類可讀的描述_str_如果查找失敗。 **See also** [errorString](qhostinfo.html#errorString)（）和[setError](qhostinfo.html#setError)（）。 ``` QHostInfo.setHostName (self, QString?name) ``` 設置該主機名[QHostInfo](qhostinfo.html)至_hostName_。 **See also** [hostName](qhostinfo.html#hostName)（）。 ``` QHostInfo.setLookupId (self, int?id) ``` 設置此查詢的ID_id_。 **See also** [lookupId](qhostinfo.html#lookupId)（）和[lookupHost](qhostinfo.html#lookupHost)（）。