QHostInfo Class

成员函数文档

[explicit] QHostInfo::QHostInfo(int id = -1)

创建一个查找 ID 为id 的空主机信息对象。

另请参阅 lookupId()。

QHostInfo::QHostInfo(const QHostInfo &other)

创建other 的一个副本。

[noexcept] QHostInfo::QHostInfo(QHostInfo &&other)

从 `other` 创建一个新的 `QHostInfo` 对象。

[noexcept] QHostInfo::~QHostInfo()

销毁主机信息对象。

[static] void QHostInfo::abortHostLookup(int id)

中止对 ID 为id 的主机查找，该 ID 由lookupHost() 返回。

注意：此函数是线程安全的。

另请参阅 lookupHost() 和lookupId()。

QList<QHostAddress> QHostInfo::addresses() const

返回与hostName()关联的IP地址列表。该列表可能为空。

示例：

QHostInfo info;
...
if (!info.addresses().isEmpty()) {
    QHostAddress address = info.addresses().first();
    // use the first IP address
}

另请参阅 setAddresses()、hostName() 和error()。

[static, since 6.12] void QHostInfo::clearCache()

清除由lookupHost() 和fromName() 使用的内部 DNS 缓存。

当缓存的主机信息可能已过期且需要进行最新查询时，请调用此方法。典型用例包括：

• 应用程序检测到网络配置发生变化（例如在 Wi-Fi 和以太网之间切换，或 VPN 连接/断开）。
• 已知某服务器的地址已发生变更（例如动态 DNS 或故障转移），应用程序应重新解析该主机名。请注意，上游 DNS 服务器和解析器拥有各自的 TTL，在此处清除缓存不会影响它们，因此在新查询中，在上游 TTL 过期之前，仍可能返回之前的地址。
• 应用程序使用缓存结果进行查询，但如果缓存已过期或不再有效，则需要进行新的查询。

此函数仅清除缓存。它不会取消正在进行的查询；这些查询将完成，其结果仍会送达。当您希望未来的查询重新解析，同时不影响正在进行的操作时，请使用此函数。

注意：此函数是线程安全的。

该函数在 Qt 6.12 中引入。

另请参见 lookupHost() 和fromName()。

QHostInfo::HostInfoError QHostInfo::error() const

如果主机名查询失败，则返回发生的错误类型；否则返回NoError 。

另请参阅 setError() 和errorString()。

QString QHostInfo::errorString() const

如果查找失败，该函数将返回一条易于理解的错误说明；否则返回“未知错误”。

另请参阅 setErrorString() 和error()。

[static] QHostInfo QHostInfo::fromName(const QString &name)

查询给定主机name 的 IP 地址。该函数在查询过程中会阻塞，这意味着程序的执行将暂停，直到查询结果准备就绪。将查询结果返回至一个QHostInfo 对象中。

如果向name 传递的是 IP 地址字面量而非主机名，QHostInfo 将搜索该 IP 地址对应的域名（即QHostInfo 将执行反向解析）。成功时，返回的QHostInfo 将同时包含该主机名的解析域名和 IP 地址。

注意：此函数是线程安全的。

另请参阅 lookupHost()。

QString QHostInfo::hostName() const

返回其IP地址被查询的主机名称。

另请参阅 setHostName() 和localHostName()。

[static] QString QHostInfo::localDomainName()

返回此计算机的 DNS 域。

注意：此函数是线程安全的。

另请参阅 hostName()。

[static] QString QHostInfo::localHostName()

返回该机器的主机名（如果已配置）。请注意，主机名并不保证在全球范围内唯一，尤其是当它们是自动配置时。

此函数不保证返回的主机名是完全限定域名（FQDN）。如需将返回的名称解析为 FQDN，请使用fromName()。

此函数的返回结果与QSysInfo::machineHostName() 相同。

注意：此函数是线程安全的。

另请参阅 hostName() 和localDomainName()。

[static] int QHostInfo::lookupHost(const QString &name, const QObject *receiver, const char *member)

查询与主机名name 关联的 IP 地址，并返回该查询的 ID。当查询结果准备就绪时，会通过QHostInfo 参数调用receiver 中的槽或信号member 。随后，可检查QHostInfo 对象以获取查询结果。

查找操作通过单次函数调用完成，例如：

QHostInfo::lookupHost("www.kde.org", this, &MyWidget::lookedUp);

该槽的实现会打印查找返回的地址的基本信息，或在查找失败时报告错误：

voidMyWidget::lookedUp(constQHostInfo&host)
{
    if(host.error()!=QHostInfo::NoError) {
        qDebug() << "Lookup failed:" << host.errorString();
       return;
    }

    const autoaddresses=host.addresses();
    for(constQHostAddress&address: addresses)
        qDebug() << "Found address:" << address.toString();
}

如果您向name 传递的是字面 IP 地址而非主机名，QHostInfo 将搜索该 IP 对应的域名（即QHostInfo 将执行反向查询）。若查询成功，生成的QHostInfo 将同时包含解析后的域名和该主机名的 IP 地址。示例：

QHostInfo::lookupHost("4.2.2.1", this, &MyWidget::lookedUp);

注意：此函数是线程安全的。

另请参阅 abortHostLookup()、addresses()、error() 和fromName()。

[static] template <typename Functor> int QHostInfo::lookupHost(const QString &name, Functor &&functor)

查询与主机名name 关联的 IP 地址，并返回该查询的 ID。当查询结果准备就绪时，会通过QHostInfo 参数调用functor 函数。随后可通过检查QHostInfo 对象来获取查询结果。

functor 将在调用 lookupHost 的线程中运行；该线程必须有一个正在运行的 Qt 事件循环。

注意：此函数是线程安全的。

另请参阅 abortHostLookup()、addresses()、error() 和fromName()。

[static] template <typename Functor> int QHostInfo::lookupHost(const QString &name, const QObject *context, Functor functor)

查询与主机名name 关联的 IP 地址，并返回一个查询 ID。当查询结果准备就绪时，会调用functor 方法，并传入QHostInfo 参数。随后可通过检查QHostInfo 对象来获取查询结果。

如果在查询完成之前销毁了context ，则不会调用functor 。functor 将在context 所属的线程中执行。上下文所属的线程必须有一个正在运行的Qt事件循环。

以下是该函数的另一种签名：

lookupHost(const QString &name, const QObject *receiver, PointerToMemberFunction function)

在这种情况下，当查找结果准备就绪时，receiver 中的槽或信号function 将被调用，并传入QHostInfo 作为参数。随后可以检查QHostInfo 对象以获取查找结果。

注意：此函数是线程安全的。

另请参阅 abortHostLookup()、addresses()、error() 以及fromName()。

int QHostInfo::lookupId() const

返回此查找的 ID。

另请参阅 setLookupId()、abortHostLookup() 和hostName()。

void QHostInfo::setAddresses(const QList<QHostAddress> &addresses)

将此QHostInfo 中的地址列表设置为addresses 。

另请参阅 addresses()。

void QHostInfo::setError(QHostInfo::HostInfoError error)

将此QHostInfo 的错误类型设置为error 。

另请参阅 error() 和errorString()。

void QHostInfo::setErrorString(const QString &str)

如果查找失败，则将发生的错误的通俗描述设置为str 。

另请参阅 errorString() 和setError()。

void QHostInfo::setHostName(const QString &hostName)

将此QHostInfo 的主机名设置为hostName 。

另请参阅 hostName()。

void QHostInfo::setLookupId(int id)

将此查找的 ID 设置为id 。

另请参阅 lookupId() 和lookupHost()。

[noexcept] void QHostInfo::swap(QHostInfo &other)

将此主机信息替换为other 。此操作非常快，且绝不会失败。

[noexcept] QHostInfo &QHostInfo::operator=(QHostInfo &&other)

将other 通过移动赋值操作赋值给此QHostInfo 实例。

QHostInfo &QHostInfo::operator=(const QHostInfo &other)

将other 对象的数据赋值给此主机信息对象，并返回对其的引用。