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)

终止由lookupHost() 返回的 ID 为id 的主机查询。

另请参阅 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()。

QHostInfo::HostInfoError QHostInfo::error() const

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

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

QString QHostInfo::errorString() const

如果查找失败，该函数将返回一个可读的错误描述；否则将返回 "未知错误"。

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

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

查找给定主机的 IP 地址name 。在查询过程中，函数将被阻塞，这意味着程序的执行将暂停，直到查询结果出来为止。在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）。为此，请使用fromName() 将返回的名称解析为 FQDN。

该函数的返回值与QSysInfo::machineHostName() 相同。

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

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

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

查询只需调用一次函数即可完成，例如

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

槽的实现会打印查找返回地址的基本信息，如果查找失败则会报错：

voidMyWidget::lookedUp(constQHostInfo&host) {如果（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。当查询结果就绪时，将调用带有QHostInfo 参数的functor 。然后就可以检查QHostInfo 对象，获取查询结果。

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

下面是函数的另一种签名：

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 对象的数据赋值给主机信息对象，并返回该对象的引用。