一、描述
QHostAddress 以独立于平台和协议的方式保存 IPv4 或 IPv6 地址。此类通常与 QTcpSocket、QTcpServer 和 QUdpSocket 一起使用以连接到主机或设置服务器。
二、类型成员
1、QHostAddress::SpecialAddress:特殊地址
- Null:空地址对象。等效于 QHostAddress()。
- LocalHost:IPv4 本地主机地址。等效于 QHostAddress("127.0.0.1")。
- LocalHostIPv6:IPv6 本地主机地址。等效于 QHostAddress("::1")。
- Broadcast:IPv4 广播地址。等效于 QHostAddress("255.255.255.255")。
- AnyIPv4:IPv4 任意地址。等效于 QHostAddress("0.0.0.0")。与此地址绑定的socket将仅侦听 IPv4 接口。
- AnyIPv6:IPv6 任意地址。等效于 QHostAddress("::")。与此地址绑定的socket将仅侦听 IPv6 接口。
- Any:IPv4、IPv6 任意地址。与此地址绑定的socket将同时侦听 IPv4 和 IPv6 接口。
2、QHostAddress::ConversionMode:转换模式
- StrictConversion:比较两个不同协议的 QHostAddress 对象时,不要将 IPv6 地址转换为 IPv4,因此它们将始终被视为不同。
- ConvertV4MappedToIPv4:比较时转换 IPv4 映射的 IPv6 地址。(QHostAddress("::ffff:192.168.1.1")等于QHostAddress("192.168.1.1"))。
- ConvertV4CompatToIPv4:比较时转换兼容 IPv4 的 IPv6 地址。 (QHostAddress("::192.168.1.1")等于QHostAddress("192.168.1.1"))。
- ConvertLocalHost:比较时将 IPv6 环回地址转换为其 IPv4 等效地址。(QHostAddress("::1")等于QHostAddress("127.0.0.1"))。
- ConvertUnspecifiedAddress:所有未指定的地址视作相等,即 AnyIPv4、AnyIPv6 和 Any。
三、成员函数
1、void clear()
将主机地址设置为空并将协议设置为 QAbstractSocket::UnknownNetworkLayerProtocol。
2、bool isBroadcast()
地址是否 IPv4 广播地址。IPv4 广播地址是 255.255.255.255。
3、bool isEqual(const QHostAddress &other, QHostAddress::ConversionMode mode = TolerantConversion)
此主机地址与给定的其他地址是否相同。参数模式控制在不同协议的地址之间执行哪些转换。
4、bool isGlobal()
地址是否 IPv4 或 IPv6 全局地址(全局地址作为互联网中的唯一地址,用于在互联网上进行路由)。
5、bool isInSubnet(const QHostAddress &subnet, int netmask)
如果此 IP 位于由subnet和子网掩码描述的子网中,则返回 true。
如果 IP 包含在该子网中的最低地址和最高地址之间,则该 IP 被视为属于该子网。在 IPv4 的情况下,最低地址是网络地址,而最高地址是广播地址。
如何理解子网掩码?
6、bool islinkLocal()
地址是否 IPv4 或 IPv6 链路本地地址。IPv4 链路本地地址是网络 169.254.0.0/16 中的地址。 IPv6 链路本地地址是网络 fe80::/10 中的地址之一。
7、bool isLoopback()
地址是否 IPv6或IPv4 环回地址。
8、bool isMulticast()
地址是否 IPv4 或 IPv6 多播地址。
9、bool isNull()
是否空地址。
10、bool isUniqueLocalUnicast()
地址是否 IPv6 唯一本地单播地址。
11、[static] QPair<QHostAddress, int> parseSubnet(const QString &subnet)
解析子网中包含的 IP 和子网信息,并返回该网络的网络前缀及其前缀长度。IP 地址和网络掩码必须用斜杠 (/) 分隔。
12、QAbstractSocket::NetworkLayerProtocol protocol()