QNetworkInterface Class Reference · PyQt4 中文文檔

# QNetworkInterface Class Reference ## [[QtNetwork](index.htm) module] 該QNetworkInterface類提供??主機的IP地址和網絡接口的列表。[More...](#details) ### Types * `enum InterfaceFlag { IsUp, IsRunning, CanBroadcast, IsLoopBack, IsPointToPoint, CanMulticast }` * `class **[InterfaceFlags](index.htm)**` ### Methods * `__init__ (self)` * `__init__ (self, QNetworkInterface?other)` * `list-of-QNetworkAddressEntry addressEntries (self)` * `InterfaceFlags flags (self)` * `QString hardwareAddress (self)` * `QString humanReadableName (self)` * `int index (self)` * `bool isValid (self)` * `QString name (self)` ### Static Methods * `list-of-QHostAddress allAddresses ()` * `list-of-QNetworkInterface allInterfaces ()` * `QNetworkInterface interfaceFromIndex (int?index)` * `QNetworkInterface interfaceFromName (QString?name)` * * * ## Detailed Description 該QNetworkInterface類提供??主機的IP地址和網絡接口的列表。 QNetworkInterface表示連接到該程序正在運行主機一個網絡接口。每個網絡接口可以包含零個或多個IP地址，其中每一個與一個掩碼和/或廣播地址是任選關聯。可以得到這樣的三重奏列表[addressEntries](qnetworkinterface.html#addressEntries)（）。或者，當網絡掩碼或廣播地址是沒有必要的，使用[allAddresses](qnetworkinterface.html#allAddresses)（）方便的功能，僅僅獲得了IP地址。 QNetworkInterface還報告與接口的硬件地址[hardwareAddress](qnetworkinterface.html#hardwareAddress)（）。并非所有操作系統都支持報告的所有功能。只有IPv4地址，保證在所有平臺上被列入這個類別。特別是， IPv6地址的清單只支持Windows XP和更新的版本， Linux的， MacOS X和BSD系統。 * * * ## Type Documentation ``` QNetworkInterface.InterfaceFlag ``` 指定與此網絡接口關聯的標志。可能的值有： | Constant | Value | Description | | --- | --- | --- | | `QNetworkInterface.IsUp` | `0x1` | 網絡接口是活動的 | | `QNetworkInterface.IsRunning` | `0x2` | 網絡接口具有分配資源 | | `QNetworkInterface.CanBroadcast` | `0x4` | 網絡接口工作在廣播模式 | | `QNetworkInterface.IsLoopBack` | `0x8` | 網絡接口是Loopback接口：也就是說，它是一個虛擬接口，其目的是主機本身 | | `QNetworkInterface.IsPointToPoint` | `0x10` | 網絡接口是一個點至點接口：就是有一個，可以通過它直接到達單其他地址。 | | `QNetworkInterface.CanMulticast` | `0x20` | 網絡接口支持多播 | 請注意，一個網絡接口不能同時基于廣播和點至點。該InterfaceFlags類型是一個typedef為[QFlags](index.htm)\u003cInterfaceFlag\u003e 。它存儲InterfaceFlag值的或組合。 * * * ## Method Documentation ``` QNetworkInterface.__init__ (self) ``` 構造一個空的網絡接口對象。 ``` QNetworkInterface.__init__ (self, QNetworkInterface?other) ``` 創建的副本[QNetworkInterface](qnetworkinterface.html)包含的對象_other_。 ``` list-of-QNetworkAddressEntry QNetworkInterface.addressEntries (self) ``` 返回的IP地址列表，該接口具有與它們相關的子網掩碼和廣播地址。如果網絡掩碼或廣播地址的信息是沒有必要的，你可以調用[allAddresses](qnetworkinterface.html#allAddresses)（）函數來獲得公正的IP地址。 ``` list-of-QHostAddress QNetworkInterface.allAddresses () ``` 這種便利函數返回的主機上找到的所有IP地址。這等同于調用[addressEntries](qnetworkinterface.html#addressEntries)（）對所有返回的對象[allInterfaces](qnetworkinterface.html#allInterfaces)（）獲得的列表[QHostAddress](qhostaddress.html)對象然后調用QHostAddress.ip （）在每個這些。 ``` list-of-QNetworkInterface QNetworkInterface.allInterfaces () ``` 將返回所有在主機上找到的網絡接口的列表。 ``` InterfaceFlags QNetworkInterface.flags (self) ``` [ 返回與此網絡接口關聯的標志。 ``` QString QNetworkInterface.hardwareAddress (self) ``` 返回低級別的硬件地址為這個接口。在以太網接口，這將是一個MAC地址的字符串表示形式，由冒號分隔。其他接口類型可以有其他類型的硬件地址。實現不應該依賴于這個函數返回一個有效的MAC地址。 ``` QString QNetworkInterface.humanReadableName (self) ``` ](index.htm) [返回在Windows上，如“本地連接” ，如果該名稱可確定此網絡接口的可讀名稱。如果不能，則該函數返回相同](index.htm)[name](qnetworkinterface.html#name)（）。人類可讀的名稱是一個名稱，用戶可以在Windows控制面板中修改，所以它可以在程序執行期間改變。在Unix中，這個功能目前總是返回相同[name](qnetworkinterface.html#name)（），因為Unix系統都配置不存儲為人類可讀的名稱。此功能被引入Qt的4.5 。 ``` int QNetworkInterface.index (self) ``` 返回接口系統索引，如果知道的話。這是分配由操作系統來識別這個接口，它通常不發生變化的整數。它在IPv6地址匹配的范圍ID字段。如果索引不知道，這個函數返回0 。此功能被引入Qt的4.5 。 ``` QNetworkInterface QNetworkInterface.interfaceFromIndex (int?index) ``` [](qnetworkinterface.html) [返回](qnetworkinterface.html)[QNetworkInterface](qnetworkinterface.html)為對象的內部ID是接口_index_。網絡接口具有所謂的“接口索引”，以從其他接口區分開來在系統上的唯一標識符。通常，這個值是逐步分配和被移除的接口，然后再加入每一次得到不同的值。該指數還發現，在IPv6地址“范圍ID字段。 ``` QNetworkInterface QNetworkInterface.interfaceFromName (QString?name) ``` [](qnetworkinterface.html) [返回](qnetworkinterface.html)[QNetworkInterface](qnetworkinterface.html)對象命名接口_name_。如果沒有這樣的接口存在，該函數返回一個無效的[QNetworkInterface](qnetworkinterface.html)對象。 **See also** [name](qnetworkinterface.html#name)（）和[isValid](qnetworkinterface.html#isValid)（）。 ``` bool QNetworkInterface.isValid (self) ``` 返回True如果[QNetworkInterface](qnetworkinterface.html)對象包含一個網絡接口的有效信息。 ``` QString QNetworkInterface.name (self) ``` 返回此網絡接口的名稱。在Unix系統中，這是一個包含接口的類型和任選的序列號，如“ eth0的”，“ LO ”或“ pcn0 ”的字符串。在Windows上，它是不能被用戶改變的內部ID 。