Qt之QHostAddress 类的使用

最新推荐文章于 2025-04-12 16:54:44 发布

liyuxia_1991

最新推荐文章于 2025-04-12 16:54:44 发布

阅读量3.8w

点赞数 16

文章标签： Qt QHostAddress

本文介绍Qt中如何使用QHostAddress类获取和处理IPv4和IPv6地址，包括获取本机IP地址、过滤本地链路地址及私有IPV4地址的方法。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

最近在qt上做一些应用时，用到Qt获取本机IP地址的相关接口，看到网友写的一篇文章很有参考价值，故转载过来方便以后查找参考。

简述

QHostAddress类提供一个IP地址。

这个类提供一种独立于平台和协议的方式来保存IPv4和IPv6地址。

QHostAddress通常与QTcpSocket、QTcpServer、QUdpSocket一起使用，来连接到主机或建立一个服务器。

可以通过setAddress()来设置一个主机地址，使用toIPv4Address()、toIPv6Address()或toString()来检索主机地址。你可以通过protocol()来检查协议类型。

注意： QHostAddress不做DNS查询，而QHostInfo是有必要的。

这个类还支持通用的预定义地址：Null、LocalHost、LocalHostIPv6、Broadcast和Any。

常用接口

枚举 QHostAddress::SpecialAddress：

常量	值	描述
QHostAddress::Null	0	空地址对象，相当于QHostAddress()。
QHostAddress::LocalHost	2	IPv4本地主机地址，相当于QHostAddress(“127.0.0.1”)。
QHostAddress::LocalHostIPv6	3	IPv6本地主机地址，相当于 QHostAddress(“::1”)。
QHostAddress::Broadcast	1	Pv4广播地址，相当于QHostAddress(“255.255.255.255”)。
QHostAddress::AnyIPv4	6	IPv4 any-address，相当于QHostAddress(“0.0.0.0”)。与该地址绑定的socket将只监听IPv4接口。
QHostAddress::AnyIPv6	5	IPv6 any-address，相当于QHostAddress(“::”)。与该地址绑定的socket将只监听IPv4接口。
QHostAddress::Any	4	双any-address栈，与该地址绑定的socket将侦听IPv4和IPv6接口。

bool isLoopback() const

如果地址是IPv6的环回地址，或任何IPv4的环回地址，则返回true。

bool isNull() const

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

QAbstractSocket::NetworkLayerProtocol protocol() const

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

QString scopeId() const

返回IPv6地址的范围ID。对于IPv4地址，如果该地址不包含范围ID，则返回一个空字符串。

IPv6的范围ID指定非全球IPv6地址范围的可达性，限制地址可以被使用的区域。所有IPv6地址与这种可达范围相关联。范围ID用于消除那些不能保证是全局唯一性的地址。

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

节点本地（Node-local）：地址仅用于和在相同的接口（例如：环回接口是”::1”）上的服务进行通信。
链路-本地（Link-local）：地址是本地网络接口（链接），每个IPv6接口上总有一个链路-本地地址在你的主机上。链路-本地地址（”fe80…”）由本地网络适配器的MAC地址生成，不保证是唯一的。
本地-站点（Site-local）：地址是本地的网站/私有网络（例如，公司内网）地址。本地-站点地址（”fec0…”）通常是由网站路由器分布，本地站点之外不能保证是唯一的。
全球（Global）：用于全球可路由地址，例如：Internet上的公共服务器。

当使用链路-本地或本地-站点地址的IPv6连接，必须指定范围ID。对链路-本地地址来说，范围ID通常与接口名称（例如，”eth0”、”en1”）或数目（例如，”1”、”2”）相同。

quint32 toIPv4Address() const
quint32 toIPv4Address(bool * ok) const

返回IPv4地址为一个数字。

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

如果protocol()是IPv4Protocol，该值是有效的；如果是IPv6Protocol，并且IPv6地址是一个IPv4映射的地址，(RFC4291)。在这种情况下，ok将被设置为true；否则，它将被设置为false。

Q_IPV6ADDR toIPv6Address() const

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

Q_IPV6ADDR addr = hostAddr.toIPv6Address();
// 地址包含16位无符号字符

for (int i = 0; i < 16; ++i) {
    // 处理 addr[i]
}
 1
2
3
4
5
6
 1
2
3
4
5
6

如果protocol()是IPv6Protocol，该值是有效的；如果是IPv4Protocol，返回地址将是IPv4地址映射的IPv6地址，(RFC4291)。

QString toString() const

返回地址为一个字符串。

例如，如果地址是IPv4地址127.0.0.1，返回的字符串为“127.0.0.1”。对于IPv6字符串格式将按照RFC5952建议。对于QHostAddress::Any，IPv4地址将返回(“0.0.0.0”)

使用

简单应用

构造一个QHostAddress，通过toString()来获取对应的IP地址：

QHostAddress address = QHostAddress(QHostAddress::LocalHost);
QString strIPAddress = address.toString();
 1
2
 1
2

显然，如上所述，IP地址为：“127.0.0.1”。

获取所有主机地址

QNetworkInterface类中提供了一个便利的静态函数allAddresses()，用于返回一个QHostAddress主机地址列表。

QList<QHostAddress> list = QNetworkInterface::allAddresses();
foreach (QHostAddress address, list) {
    // 主机地址为空
    if (address.isNull())
        continue;

    qDebug() << "********************";
    QAbstractSocket::NetworkLayerProtocol nProtocol = address.protocol();
    QString strScopeId = address.scopeId();
    QString strAddress = address.toString();
    bool bLoopback = address.isLoopback();

    // 如果是IPv4
    if (nProtocol == QAbstractSocket::IPv4Protocol) {
        bool bOk = false;
        quint32 nIPV4 = address.toIPv4Address(&bOk);
        if (bOk)
            qDebug() << "IPV4 : " << nIPV4;
    }
    // 如果是IPv6
    else if (nProtocol == QAbstractSocket::IPv6Protocol) {
        QStringList IPV6List("");
        Q_IPV6ADDR IPV6 = address.toIPv6Address();
        for (int i = 0; i < 16; ++i) {
            quint8 nC = IPV6[i];
            IPV6List << QString::number(nC);
        }
        qDebug() << "IPV6 : " << IPV6List.join(" ");
    }

    qDebug() << "Protocol : " << nProtocol;
    qDebug() << "ScopeId : " << strScopeId;
    qDebug() << "Address : " << strAddress;
    qDebug() << "IsLoopback  : " << bLoopback;
}
 1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
 1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35

输出如下：

IPV6 : ” 254 128 0 0 0 0 0 0 85 12 171 25 251 72 1 201”
Protocol : QAbstractSocket::NetworkLayerProtocol(IPv6Protocol)
ScopeId : “15”
Address : “fe80::550c:ab19:fb48:1c9%15”
IsLoopback : false

IPV4 : 2851996105
Protocol : QAbstractSocket::NetworkLayerProtocol(IPv4Protocol)
ScopeId : “”
Address : “169.254.1.201”
IsLoopback : false

IPV6 : ” 254 128 0 0 0 0 0 0 208 134 133 102 96 101 137 84”
Protocol : QAbstractSocket::NetworkLayerProtocol(IPv6Protocol)
ScopeId : “11”
Address : “fe80::d086:8566:6065:8954%11”
IsLoopback : false

IPV4 : 2886861989
Protocol : QAbstractSocket::NetworkLayerProtocol(IPv4Protocol)
ScopeId : “”
Address : “172.18.4.165”
IsLoopback : false

IPV6 : ” 254 128 0 0 0 0 0 0 248 100 169 98 114 25 249 142”
Protocol : QAbstractSocket::NetworkLayerProtocol(IPv6Protocol)
ScopeId : “16”
Address : “fe80::f864:a962:7219:f98e%16”
IsLoopback : false

IPV4 : 3232239873
Protocol : QAbstractSocket::NetworkLayerProtocol(IPv4Protocol)
ScopeId : “”
Address : “192.168.17.1”
IsLoopback : false

IPV6 : ” 254 128 0 0 0 0 0 0 129 105 105 31 20 142 211 203”
Protocol : QAbstractSocket::NetworkLayerProtocol(IPv6Protocol)
ScopeId : “17”
Address : “fe80::8169:691f:148e:d3cb%17”
IsLoopback : false

IPV4 : 3232281089
Protocol : QAbstractSocket::NetworkLayerProtocol(IPv4Protocol)
ScopeId : “”
Address : “192.168.178.1”
IsLoopback : false

IPV6 : ” 254 128 0 0 0 0 0 0 89 150 39 163 131 181 42 231”
Protocol : QAbstractSocket::NetworkLayerProtocol(IPv6Protocol)
ScopeId : “18”
Address : “fe80::5996:27a3:83b5:2ae7%18”
IsLoopback : false

IPV4 : 3232249857
Protocol : QAbstractSocket::NetworkLayerProtocol(IPv4Protocol)
ScopeId : “”
Address : “192.168.56.1”
IsLoopback : false

IPV6 : ” 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1”
Protocol : QAbstractSocket::NetworkLayerProtocol(IPv6Protocol)
ScopeId : “”
Address : “::1”
IsLoopback : true

IPV4 : 2130706433
Protocol : QAbstractSocket::NetworkLayerProtocol(IPv4Protocol)
ScopeId : “”
Address : “127.0.0.1”
IsLoopback : true

我们可以获取到很多地址，有可能包含：本例链路地址、私有的IPV4地址等，但是在应用过程中大部分需要进行过滤。

过滤

本地链路地址

本地链路地址范围：169.254.1.0 - 169.254.254.255
参考：http://en.wikipedia.org/wiki/Private_network

bool isLinkLocalAddress(QHostAddress addr){
    quint32 nIPv4 = addr.toIPv4Address();
    quint32 nMinRange = QHostAddress("169.254.1.0").toIPv4Address();
    quint32 nMaxRange = QHostAddress("169.254.254.255").toIPv4Address();
    if ((nIPv4 >= nMinRange) && (nIPv4 <= nMaxRange)) {
        return true;
    } else {
        return false;
    }
}
 1
2
3
4
5
6
7
8
9
10
 1
2
3
4
5
6
7
8
9
10

私有IPV4地址

私有IPV4地址范围：

10.0.0.0 - 10.255.255.255
172.16.0.0 - 172.31.255.255
192.168.0.0 - 192.168.255.255

参考：http://en.wikipedia.org/wiki/Private_network

bool isLocalIP(QHostAddress addr){
    quint32 nIPv4 = addr.toIPv4Address();
    quint32 nMinRange1 = QHostAddress("10.0.0.0").toIPv4Address();
    quint32 nMaxRange1 = QHostAddress("10.255.255.255").toIPv4Address();

    quint32 nMinRange2 = QHostAddress("172.16.0.0").toIPv4Address();
    quint32 nMaxRange2 = QHostAddress("172.31.255.255").toIPv4Address();

    quint32 nMinRange3 = QHostAddress("192.168.0.0").toIPv4Address();
    quint32 nMaxRange3 = QHostAddress("192.168.255.255").toIPv4Address();

    if ((nIPv4 >= nMinRange1 && nIPv4 <= nMaxRange1)
            || (nIPv4 >= nMinRange2 && nIPv4 <= nMaxRange2)
            || (nIPv4 >= nMinRange3 && nIPv4 <= nMaxRange3)) {
        return true;
    } else {
        return false;
    }
}
 1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
 1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19