Home · All Classes · Modules  · QSS HELP  · QSS 案例 · VER007 HOME

QHostAddress Class Reference
^{[QtNetwork module]}

该QHostAddress类提供一个IP地址。More...

Types

• enum SpecialAddress { Null, Broadcast, LocalHost, LocalHostIPv6, AnyIPv6, Any }

Methods

• __init__ (self)
• __init__ (self, SpecialAddress address)
• __init__ (self, int ip4Addr)
• __init__ (self, QString address)
• __init__ (self, 16-tuple-of-int ip6Addr)
• __init__ (self, QHostAddress copy)
• clear (self)
• bool isInSubnet (self, QHostAddress subnet, int netmask)
• bool isInSubnet (self, tuple-of-QHostAddress-int subnet)
• bool isNull (self)
• QAbstractSocket.NetworkLayerProtocol protocol (self)
• QString scopeId (self)
• setAddress (self, int ip4Addr)
• bool setAddress (self, QString address)
• setAddress (self, 16-tuple-of-int ip6Addr)
• setScopeId (self, QString id)
• int toIPv4Address (self)
• 16-tuple-of-int toIPv6Address (self)
• QString toString (self)

Static Methods

• tuple-of-QHostAddress-int parseSubnet (QString subnet)

Special Methods

• bool __eq__ (self, QHostAddress address)
• bool __eq__ (self, SpecialAddress address)
• int __hash__ (self)
• bool __ne__ (self, QHostAddress address)
• bool __ne__ (self, SpecialAddress address)

Detailed Description

该QHostAddress类提供一个IP地址。

此类包含IPv4或IPv6地址在一个平台和协议无关的方式。

QHostAddress通常与所使用的QTcpSocket，QTcpServer和QUdpSocket连接到主机或设立一个服务器。

主机地址设置与setAddress（） ，并检索与toIPv4Address（ ）toIPv6Address（） ，或toString（ ） 。您可以检查与类型protocol（ ） 。

Note:请注意， QHostAddress没有做DNS查找。QHostInfo是需要这一点。

该类还支持常见的预定义的地址：Null，LocalHost，LocalHostIPv6，Broadcast和Any。

Type Documentation

QHostAddress.SpecialAddress

Method Documentation

QHostAddress.__init__ (self)

构造一个主机地址对象的IP地址为0.0.0.0 。

See also clear（ ） 。

QHostAddress.__init__ (self, SpecialAddress address)

构造一个主机地址对象的IPv4地址ip4Addr。

QHostAddress.__init__ (self, int ip4Addr)

构造一个主机地址对象的IPv6地址ip6Addr。

ip6Addr必须是网络字节顺序（大端）一个16字节的数组。

QHostAddress.__init__ (self, QString address)

构造一个主机地址对象的IPv6地址ip6Addr。

QHostAddress.__init__ (self, 16-tuple-of-int ip6Addr)

构造使用由天然结构中指定的地址的IPv4或IPv6地址sockaddr。

See also setAddress（ ） 。

QHostAddress.__init__ (self, QHostAddress copy)

构建了基于字符串的IPv4或IPv6地址address（例如， “127.0.0.1” ） 。

See also setAddress（ ） 。

QHostAddress.clear (self)

设置主机地址为0.0.0.0 。

bool QHostAddress.isInSubnet (self, QHostAddress subnet, int netmask)

返回True如果这个IP是由网络前缀描述的子网subnet和网络掩码netmask。

一个IP被认为是属于一个子网，如果它包含的最低和该子网中的最高地址。在IP版本4的情况下，最低的地址是网络地址，而最高地址是广播地址。

该subnet参数并不一定是实际的网络地址（子网中的最低地址） 。它可以是属于该子网的任何有效的IP地址。特别是，如果它等于通过这个对象持有的IP地址，这个函数将始终返回True （所提供的网络掩码是一个有效的值） 。

此功能被引入Qt的4.5 。

See also parseSubnet（ ） 。

bool QHostAddress.isInSubnet (self, tuple-of-QHostAddress-int subnet)

这是一个重载函数。

返回True如果这个IP是由描述的子网subnet。该QHostAddress成员subnet包含网络前缀和整数（二）成员包含子网掩码（前缀长度） 。

此功能被引入Qt的4.5 。

bool QHostAddress.isNull (self)

返回True如果主机地址为空（ INADDR_ANY或IN6ADDR_ANY ） 。默认的构造函数创建一个空的地址，该地址是无效的任何主机或接口。

tuple-of-QHostAddress-int QHostAddress.parseSubnet (QString subnet)

解析包含在IP和子网信息subnet并返回网络前缀的网络前缀长度。

IP地址和网络掩码必须以斜杠（ / ）分隔。

此功能支持形式参数：

• 123.123.123.123/n where n is any value between 0 and 32
• 123.123.123.123/255.255.255.255
• <ipv6-address>/n where n is any value between 0 and 128

对于IP版本4 ，这个函数接受以及缺少结尾的部分（即，小于4个字节，如“ 192.168.1 ” ），其次或不点。如果子网掩码也在这种情况下丢失，它被设置为实际传递的字节数（在上面的例子中，这将是24 ，为3个八比特组） 。

此功能被引入Qt的4.5 。

See also isInSubnet（ ） 。

QAbstractSocket.NetworkLayerProtocol QHostAddress.protocol (self)

返回主机地址中的网络层协议。

QString QHostAddress.scopeId (self)

返回一个IPv6地址的范围ID 。对于IPv4地址，或者地址不包含范围ID ，一个空QString返回。

IPv6的范围ID指定的范围reachability对于非全局IPv6地址，限制在其中的地址可使用的区域。所有的IPv6地址与这样的可达范围有关。范围ID被用来消除那些不能保证是全局唯一的地址。

的IPv6指定了以下四个层次的可达性：

• Node-local: Addresses that are only used for communicating with services on the same interface (e.g., the loopback interface ".1").
• Link-local: Addresses that are local to the network interface (link). There is always one link-local address for each IPv6 interface on your host. Link-local addresses ("fe80...") are generated from the MAC address of the local network adaptor, and are not guaranteed to be unique.
• Site-local: Addresses that are local to the site / private network (e.g., the company intranet). Site-local addresses ("fec0...") are usually distributed by the site router, and are not guaranteed to be unique outside of the local site.
• Global: For globally routable addresses, such as public servers on the Internet.

当使用链路本地和站点本地地址的IPv6连接，则必须指定范围ID 。一个链路本地地址的范围ID通常是相同的接口名称（例如，“ eth0的” ， “ EN1 ” ）或数字（例如， “ 1 ” ， “2” ） 。

这个函数是Qt 4.1中引入。

See also setScopeId（ ） 。

QHostAddress.setAddress (self, int ip4Addr)

通过设置指定的IPv4地址ip4Addr。

bool QHostAddress.setAddress (self, QString address)

这是一个重载函数。

通过设置指定的IPv6地址ip6Addr。

ip6Addr必须是网络字节顺序（高位字节在前） 16字节的数组。

QHostAddress.setAddress (self, 16-tuple-of-int ip6Addr)

这是一个重载函数。

通过设置指定的IPv6地址ip6Addr。

QHostAddress.setScopeId (self, QString id)

设置地址的IPv6范围ID来id。如果地址协议是不支持IPv6 ，这个函数不执行任何操作。

这个函数是Qt 4.1中引入。

See also scopeId（ ） 。

int QHostAddress.toIPv4Address (self)

返回的IPv4地址为一个数字。

例如，如果地址是127.0.0.1 ，则返回值是2130706433 （即0x7f000001 ） 。

此值才有效，如果该协议（ ）是IPv4Protocol。

See also toString（ ） 。

16-tuple-of-int QHostAddress.toIPv6Address (self)

返回IPv6地址作为Q_IPV6ADDR结构。该结构由16位无符号的字符。

 Q_IPV6ADDR addr = hostAddr.toIPv6Address();
 // addr contains 16 unsigned characters

 for (int i = 0; i < 16; ++i) {
     // process addr[i]
 }

此值才有效，如果protocol（）是IPv6Protocol。

See also toString（ ） 。

QString QHostAddress.toString (self)

返回该地址为一个字符串。

例如，如果该地址是IPv4地址127.0.0.1 ，则返回的字符串为“ 127.0.0.1” 。对于IPv6的字符串格式将遵循RFC5952建议。

See also toIPv4Address（ ） 。

bool QHostAddress.__eq__ (self, QHostAddress address)

bool QHostAddress.__eq__ (self, SpecialAddress address)

int QHostAddress.__hash__ (self)

bool QHostAddress.__ne__ (self, QHostAddress address)

bool QHostAddress.__ne__ (self, SpecialAddress address)