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

  1. QHostAddress.SpecialAddress
Constant Value Description
QHostAddress.Null 0 空地址的对象。相当于QHostAddress（ ） 。
QHostAddress.LocalHost 2 在本地主机的IPv4地址。相当于QHostAddress（ “127.0.0.1” ） 。
QHostAddress.LocalHostIPv6 3 IPv6的本地主机地址。相当于QHostAddress（ “.1” ） 。
QHostAddress.Broadcast 1 IPv4的广播地址。相当于QHostAddress（ “255.255.255.255” ） 。
QHostAddress.Any 4 IPv4的任何地址。相当于QHostAddress（ “0.0.0.0” ） 。
QHostAddress.AnyIPv6 5 IPv6的任何地址。相当于QHostAddress（ “.“ ） 。

Method Documentation

  1. QHostAddress.__init__ (self)

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

See also clear（ ） 。

  1. QHostAddress.__init__ (self, SpecialAddress address)

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

  1. QHostAddress.__init__ (self, int ip4Addr)

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

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

  1. QHostAddress.__init__ (self, QString address)

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

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

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

See also setAddress（ ） 。

  1. QHostAddress.__init__ (self, QHostAddress copy)

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

See also setAddress（ ） 。

  1. QHostAddress.clear (self)

设置主机地址为0.0.0.0 。

  1. 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（ ） 。

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

这是一个重载函数。

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

此功能被引入Qt的4.5 。

  1. bool QHostAddress.isNull (self)

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

  1. 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（ ） 。

  1. QAbstractSocket.NetworkLayerProtocol QHostAddress.protocol (self)

[

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

  1. QString QHostAddress.scopeId (self)

]($docs-qabstractsocket.html#NetworkLayerProtocol-enum)

返回一个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（ ） 。

  1. QHostAddress.setAddress (self, int ip4Addr)

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

  1. bool QHostAddress.setAddress (self, QString address)

这是一个重载函数。

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

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

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

这是一个重载函数。

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

  1. QHostAddress.setScopeId (self, QString id)

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

这个函数是Qt 4.1中引入。

See also scopeId（ ） 。

  1. int QHostAddress.toIPv4Address (self)

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

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

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

See also toString（ ） 。

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

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

  1.  Q_IPV6ADDR addr = hostAddr.toIPv6Address();
  2.  // addr contains 16 unsigned characters
  4.  for (int i = 0; i < 16; ++i) {
  5.      // process addr[i]
  6.  }

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

See also toString（ ） 。

  1. QString QHostAddress.toString (self)

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

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

See also toIPv4Address（ ） 。

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