Класс QHostInfo

Класс QHostInfo предоставляет статические функции для поиска имен хостов. Подробнее...

• Список всех членов, включая наследуемые

Примечание: Все функции этого класса являются реентерабельными.

Типы

Открытые функции

Статические публичные члены

Подробное описание

QHostInfo находит IP-адрес(ы), связанный с именем хоста, или имя хоста, связанное с IP-адресом. Класс предоставляет две статические удобные функции: одна работает асинхронно и генерирует сигнал после того, как хост будет найден, а другая блокирует и возвращает объект QHostInfo.

Для асинхронного поиска IP-адресов хоста вызовите lookupHost(), которая принимает имя хоста или IP-адрес, объект получателя и сигнатуру слота в качестве аргументов и возвращает идентификатор. Вы можете прервать поиск, вызвав abortHostLookup() с идентификатором поиска.

Пример:

// To find the IP address of qt-project.org
QHostInfo::lookupHost("qt-project.org",
                      this, SLOT(printResults(QHostInfo)));

// To find the host name for 4.2.2.1
QHostInfo::lookupHost("4.2.2.1",
                      this, SLOT(printResults(QHostInfo)));

Слот вызывается, когда результаты готовы. Результаты хранятся в объекте QHostInfo. Вызовите addresses(), чтобы получить список IP-адресов хоста, и hostName(), чтобы получить имя хоста, которое искалось.

Если поиск завершился неудачей, error() возвращает тип произошедшей ошибки. errorString() предоставляет удобочитаемое описание ошибки поиска.

Если вам нужен блокирующий поиск, используйте функцию QHostInfo::fromName():

QHostInfo info = QHostInfo::fromName("qt-project.org");

QHostInfo поддерживает имена международных доменов (IDN) через стандарты IDNA и Punycode.

Для получения имени локального хоста используйте статическую функцию QHostInfo::localHostName().

QHostInfo использует механизмы, предоставляемые операционной системой для выполнения поиска. Согласно {https://tools.ietf.org/html/rfc6724}{RFC 6724} нет гарантии, что все IP-адреса, зарегистрированные для домена или хоста, будут возвращены.

Примечание: Начиная с Qt 4.6.1, QHostInfo использует несколько потоков для поиска DNS вместо одного выделенного потока DNS. Это улучшает производительность, но также изменяет порядок выдачи сигналов при использовании lookupHost() по сравнению с предыдущими версиями Qt.

Примечание: Начиная с Qt 4.6.3, QHostInfo использует небольшой внутренний кеш DNS на 60 секунд для повышения производительности.

См. также QAbstractSocket, RFC 3492 и RFC 6724.

Документация по типам членов

перечисление QHostInfo::HostInfoError

Это перечисление описывает различные ошибки, которые могут возникнуть при попытке разрешить имя хоста.

См. также error() и setError().

Документация по функциям-членам

QHostInfo::QHostInfo(QHostInfo &&other)

Перемещающее создание нового QHostInfo из other.

Примечание: Перемещенный объект other помещается в частично сформированное состояние, в котором единственными допустимыми операциями являются уничтожение и присваивание нового значения.

Эта функция была добавлена в Qt 5.14.

QHostInfo::QHostInfo(const QHostInfo &other)

Создает копию other.

QHostInfo::QHostInfo(int id = -1)

Создает пустой объект информации о хосте с идентификатором поиска id.

См. также lookupId().

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

Перемещающее присваивание other этому экземпляру QHostInfo.

Примечание: Перемещенный объект other помещается в частично сформированное состояние, в котором единственными допустимыми операциями являются уничтожение и присваивание нового значения.

Эта функция была добавлена в Qt 5.10.

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

Присваивает данные объекта other объекту информации о хосте и возвращает ссылку на него.

QHostInfo::~QHostInfo()

Уничтожает объект информации о хосте.

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

Прерывает поиск хоста с идентификатором id, возвращаемым функцией lookupHost().

См. также lookupHost() и lookupId().

QList<QHostAddress> QHostInfo::addresses() const

Возвращает список IP-адресов, связанных с hostName(). Этот список может быть пустым.

Пример:

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.

Если вы передадите литеральный IP-адрес в name вместо имени хоста, QHostInfo будет искать имя домена для IP (то есть QHostInfo выполнит обратный поиск). При успехе возвращаемый QHostInfo будет содержать как разрешённое имя домена, так и IP-адреса для имени хоста.

См. также lookupHost().

QString QHostInfo::hostName() const

Возвращает имя хоста, IP-адреса которого были найдены.

См. также setHostName() и localHostName().

[static] QString QHostInfo::localDomainName()

Возвращает DNS-домен этой машины.

Примечание: DNS-домены не связаны с именами доменов, используемыми в сетях Windows.

См. также hostName().

[static] QString QHostInfo::localHostName()

Возвращает имя хоста этой машины, если оно настроено. Обратите внимание, что имена хостов не гарантируются как глобально уникальные, особенно если они были настроены автоматически.

Эта функция не гарантирует, что возвращаемое имя хоста является полным доменным именем (FQDN). Для этого используйте fromName() для разрешения возвращаемого имени в FQDN.

Эта функция возвращает то же самое, что и QSysInfo::machineHostName().

См. также hostName() и localDomainName().

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

Ищет IP-адрес(ы), связанные с именем хоста name, и возвращает идентификатор поиска. Когда результат поиска готов, вызывается слот или сигнал member в receiver с аргументом QHostInfo. Объект QHostInfo затем можно использовать для получения результатов поиска.

Поиск выполняется одним вызовом функции, например:

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

Реализация слота печатает основную информацию об адресах, возвращённых результатом поиска, или сообщает об ошибке, если она произошла:

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

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

Если вы передадите литеральный IP-адрес в name вместо имени хоста, QHostInfo будет искать имя домена для IP (то есть QHostInfo выполнит обратный поиск). При успехе полученный QHostInfo будет содержать как разрешённое имя домена, так и IP-адреса для имени хоста. Пример:

QHostInfo::lookupHost("4.2.2.1",
                      this, SLOT(lookedUp(QHostInfo)));

Примечание: Нет гарантии порядка выдачи сигналов, если вы запускаете несколько запросов с помощью lookupHost().

См. также abortHostLookup(), addresses(), error() и fromName().

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

Это перегруженная функция.

Ищет IP-адрес(ы), связанные с именем хоста name, и возвращает идентификатор поиска. Когда результат поиска готов, вызывается functor с аргументом QHostInfo. Объект QHostInfo затем можно использовать для получения результатов поиска.

Functor будет выполняться в потоке, который вызывает lookupHost; этот поток должен иметь работающий цикл событий Qt.

Примечание: Нет гарантии порядка выдачи сигналов, если вы запускаете несколько запросов с помощью lookupHost().

Эта функция была введена в Qt 5.9.

См. также abortHostLookup(), addresses(), error() и fromName().

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

Это перегруженная функция.

Ищет IP-адрес(ы), связанные с именем хоста name, и возвращает идентификатор поиска. Когда результат поиска готов, вызывается functor с аргументом QHostInfo. Объект QHostInfo затем можно использовать для получения результатов поиска.

Если context уничтожен до завершения поиска, functor не будет вызван. Functor будет выполняться в потоке context. Поток контекста должен иметь работающий цикл событий Qt.

Вот альтернативная сигнатура функции:

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

В этом случае, когда результат поиска готов, слот или сигнал function в receiver вызывается с аргументом QHostInfo. Объект QHostInfo затем можно использовать для получения результатов поиска.

Примечание: Нет гарантии порядка выдачи сигналов, если вы запускаете несколько запросов с помощью lookupHost().

Эта функция была введена в Qt 5.9.

См. также abortHostLookup(), addresses(), error() и fromName().

int QHostInfo::lookupId() const

Возвращает идентификатор этого поиска.

См. также 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.

См. также lookupId() и lookupHost().

void QHostInfo::swap(QHostInfo &other)

Меняет местами информацию о хосте other с текущей информацией о хосте. Эта операция очень быстрая и никогда не завершается ошибкой.

Эта функция была введена в Qt 5.10.