En esta página

QHostInfo Class

La clase QHostInfo proporciona funciones estáticas para la búsqueda de nombres de host. Más información...

Encabezado: #include <QHostInfo>
CMake: find_package(Qt6 REQUIRED COMPONENTS Network)
target_link_libraries(mytarget PRIVATE Qt6::Network)
qmake: QT += network

Nota: Todas las funciones de esta clase son reentrantes.

Nota: Estas funciones también son seguras para subprocesos:

Tipos públicos

enum HostInfoError { NoError, HostNotFound, UnknownError }

Funciones públicas

QHostInfo(int id = -1)
QHostInfo(const QHostInfo &other)
QHostInfo(QHostInfo &&other)
~QHostInfo()
QList<QHostAddress> addresses() const
QHostInfo::HostInfoError error() const
QString errorString() const
QString hostName() const
int lookupId() const
void setAddresses(const QList<QHostAddress> &addresses)
void setError(QHostInfo::HostInfoError error)
void setErrorString(const QString &str)
void setHostName(const QString &hostName)
void setLookupId(int id)
void swap(QHostInfo &other)
QHostInfo &operator=(QHostInfo &&other)
QHostInfo &operator=(const QHostInfo &other)

Miembros públicos estáticos

void abortHostLookup(int id)
(since 6.12) void clearCache()
QHostInfo fromName(const QString &name)
QString localDomainName()
QString localHostName()
int lookupHost(const QString &name, const QObject *receiver, const char *member)
int lookupHost(const QString &name, Functor &&functor)
int lookupHost(const QString &name, const QObject *context, Functor functor)

Descripción detallada

QHostInfo busca la dirección o direcciones IP asociadas a un nombre de host, o el nombre de host asociado a una dirección IP. La clase proporciona dos funciones estáticas de conveniencia: una que funciona de forma asíncrona y emite una señal una vez que se encuentra el host, y otra que se bloquea y devuelve un objeto QHostInfo.

Para buscar las direcciones IP de un host de forma asíncrona, llama a ` lookupHost()` (), que toma como argumentos el nombre de host o la dirección IP, un objeto receptor y una firma de ranura, y devuelve un ID. Puedes abortar la búsqueda llamando a ` abortHostLookup()` () con el ID de la búsqueda.

Ejemplo:

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

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

La ranura se invoca cuando los resultados están listos. Los resultados se almacenan en un objeto `QHostInfo`. Llama a ` addresses()` para obtener la lista de direcciones IP del host, y a ` hostName()` para obtener el nombre de host que se ha buscado.

Si la búsqueda ha fallado, error() devuelve el tipo de error que se ha producido. errorString() proporciona una descripción legible para el usuario del error de búsqueda.

Si desea realizar una búsqueda bloqueante, utilice la función ` QHostInfo::fromName()`:

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

QHostInfo admite nombres de dominio internacionalizados (IDN) a través de los estándares IDNA y Punycode.

Para recuperar el nombre del host local, utiliza la función estática QHostInfo::localHostName().

QHostInfo utiliza los mecanismos proporcionados por el sistema operativo para realizar la consulta. Según el RFC 6724, no hay garantía de que se devuelvan todas las direcciones IP registradas para un dominio u host.

Nota: Desde Qt 4.6.1, QHostInfo utiliza varios subprocesos para la búsqueda de DNS en lugar de un único subproceso dedicado a DNS. Esto mejora el rendimiento, pero también cambia el orden de emisión de señales al utilizar lookupHost() en comparación con versiones anteriores de Qt.

Nota: Desde Qt 4.6.3, QHostInfo utiliza una pequeña caché DNS interna de 60 segundos para mejorar el rendimiento.

Véase también QAbstractSocket, RFC 3492 y RFC 6724.

Documentación sobre los tipos de miembros

enum QHostInfo::HostInfoError

Esta enumeración describe los distintos errores que pueden producirse al intentar resolver un nombre de host.

ConstanteValorDescripción
QHostInfo::NoError0La búsqueda se ha realizado correctamente.
QHostInfo::HostNotFound1No se han encontrado direcciones IP para el host.
QHostInfo::UnknownError2Se ha producido un error desconocido.

Véase también error() y setError().

Documentación de funciones miembro

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

Crea un objeto de información del host vacío con el ID de búsqueda id.

Véase también lookupId().

QHostInfo::QHostInfo(const QHostInfo &other)

Crea una copia de other.

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

Crea un nuevo objeto `QHostInfo` a partir de ` other`.

Nota: El objeto del que se ha realizado el traslado, ` other `, pasa a un estado parcialmente formado, en el que las únicas operaciones válidas son la destrucción y la asignación de un nuevo valor.

[noexcept] QHostInfo::~QHostInfo()

Elimina el objeto de información del host.

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

Cancela la búsqueda del host con el ID « id », tal y como lo devuelve la función lookupHost().

Nota: Esta función es segura para subprocesos.

Véanse también lookupHost() y lookupId().

QList<QHostAddress> QHostInfo::addresses() const

Devuelve la lista de direcciones IP asociadas a hostName(). Esta lista puede estar vacía.

Ejemplo:

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

Véase también setAddresses(), hostName() y error().

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

Borra la caché interna de DNS que utilizan lookupHost() y fromName().

Llama a esta función cuando la información de los hosts almacenada en caché pueda estar desactualizada y sea necesario realizar nuevas consultas. Entre los casos de uso habituales se incluyen:

  • La aplicación ha detectado un cambio en la configuración de red (por ejemplo, cambio entre Wi-Fi y Ethernet, o conexión/desconexión de una VPN).
  • Se sabe que la dirección de un servidor ha cambiado (por ejemplo, DNS dinámico o conmutación por error), y la aplicación debe resolver de nuevo el nombre de host. Ten en cuenta que los servidores DNS y los resolutores de nivel superior tienen su propio TTL; por lo tanto, vaciar la caché aquí no les afecta, por lo que la nueva consulta puede seguir devolviendo la dirección anterior hasta que caduque el TTL de nivel superior.
  • La aplicación utiliza un resultado almacenado en caché para las búsquedas, pero requiere una nueva búsqueda si la caché ha caducado o ya no es válida.

Esta función solo vacía la caché. No cancela las búsquedas en curso; estas se completarán y sus resultados se seguirán entregando. Utilízala cuando desees que las futuras búsquedas se resuelvan de nuevo sin afectar a las operaciones en curso.

Nota: Esta función es segura para subprocesos.

Esta función se introdujo en Qt 6.12.

Véase también lookupHost() y fromName().

QHostInfo::HostInfoError QHostInfo::error() const

Devuelve el tipo de error que se ha producido si ha fallado la búsqueda del nombre de host; en caso contrario, devuelve « NoError ».

Véanse también setError() y errorString().

QString QHostInfo::errorString() const

Si la búsqueda ha fallado, esta función devuelve una descripción del error comprensible para el usuario; en caso contrario, devuelve «Error desconocido».

Véanse también setErrorString() y error().

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

Busca la(s) dirección(es) IP del host indicado name. La función se bloquea durante la búsqueda, lo que significa que la ejecución del programa queda suspendida hasta que los resultados de la búsqueda estén disponibles. Devuelve el resultado de la búsqueda en un objeto QHostInfo.

Si se pasa una dirección IP literal a name en lugar de un nombre de host, QHostInfo buscará el nombre de dominio correspondiente a dicha IP (es decir, QHostInfo realizará una búsqueda inversa ). Si la búsqueda tiene éxito, el objeto QHostInfo devuelto contendrá tanto el nombre de dominio resuelto como las direcciones IP asociadas al nombre de host.

Nota: Esta función es segura para subprocesos.

Véase también lookupHost().

QString QHostInfo::hostName() const

Devuelve el nombre del servidor cuyas direcciones IP se han consultado.

Véase también setHostName() y localHostName().

[static] QString QHostInfo::localDomainName()

Devuelve el dominio DNS de este equipo.

Nota: Los dominiosDNS no guardan relación con los nombres de dominio que se encuentran en las redes de Windows.

Nota: Esta función es segura para subprocesos.

Véase también hostName().

[static] QString QHostInfo::localHostName()

Devuelve el nombre de host de esta máquina, si se ha configurado alguno. Ten en cuenta que no se garantiza que los nombres de host sean únicos a nivel global, especialmente si se han configurado automáticamente.

Esta función no garantiza que el nombre de host devuelto sea un nombre de dominio completo (FQDN). Para ello, utilice fromName() para resolver el nombre devuelto a un FQDN.

Esta función devuelve lo mismo que QSysInfo::machineHostName().

Nota: Esta función es segura para subprocesos.

Véase también hostName() y localDomainName().

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

Busca la(s) dirección(es) IP asociada(s) al nombre de host name y devuelve un identificador para la búsqueda. Cuando el resultado de la búsqueda está listo, se invoca el slot o la señal member de receiver con un argumento QHostInfo. A continuación, se puede consultar el objeto QHostInfo para obtener los resultados de la búsqueda.

La búsqueda se realiza mediante una única llamada a una función, por ejemplo:

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

La implementación de la ranura muestra información básica sobre las direcciones devueltas por la búsqueda o notifica un error si esta ha fallado:

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

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

Si pasas una dirección IP literal a name en lugar de un nombre de host, QHostInfo buscará el nombre de dominio correspondiente a esa IP (es decir, QHostInfo realizará una búsqueda inversa ). Si la búsqueda tiene éxito, el resultado QHostInfo contendrá tanto el nombre de dominio resuelto como las direcciones IP asociadas al nombre de host. Ejemplo:

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

Nota: Nohay garantía alguna sobre el orden en que se emitirán las señales si se inician varias solicitudes con lookupHost().

Nota: En las versiones de Qt anteriores a la 6.7, esta función aceptaba « receiver » como « QObject* » (no const).

Nota: Esta función es segura para subprocesos.

Véase también abortHostLookup(), addresses(), error() y fromName().

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

Busca la(s) dirección(es) IP asociada(s) al nombre de host name y devuelve un identificador para la búsqueda. Cuando el resultado de la búsqueda está listo, se llama a la función functor con un argumento QHostInfo. A continuación, se puede examinar el objeto QHostInfo para obtener los resultados de la búsqueda.

La función ` functor ` se ejecutará en el hilo que realiza la llamada a `lookupHost`; dicho hilo debe tener un bucle de eventos de Qt en ejecución.

Nota: Nohay garantía alguna sobre el orden en que se emitirán las señales si se inician varias solicitudes con lookupHost().

Esta es una función sobrecargada.

Nota: Esta función es segura para subprocesos.

Véase también abortHostLookup(), addresses(), error() y fromName().

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

Busca la(s) dirección(es) IP asociada(s) al nombre de host name y devuelve un identificador para la consulta. Cuando el resultado de la consulta está listo, se invoca a functor con un argumento QHostInfo. A continuación, se puede examinar el objeto QHostInfo para obtener los resultados de la consulta.

Si se destruye context antes de que finalice la búsqueda, no se llamará a functor. functor se ejecutará en el hilo de context. El hilo del contexto debe tener un bucle de eventos de Qt en ejecución.

A continuación se muestra una firma alternativa para la función:

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

En este caso, cuando el resultado de la búsqueda esté listo, se llamará al slot o a la señal function de receiver con un argumento QHostInfo. A continuación, se puede inspeccionar el objeto QHostInfo para obtener los resultados de la búsqueda.

Nota: Nose garantiza el orden en que se emitirán las señales si se inician varias solicitudes con lookupHost().

Esta es una función sobrecargada.

Nota: Esta función es segura para subprocesos.

Véase también abortHostLookup(), addresses(), error() y fromName().

int QHostInfo::lookupId() const

Devuelve el ID de esta consulta.

Véase también setLookupId(), abortHostLookup() y hostName().

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

Establece la lista de direcciones de este QHostInfo a addresses.

Véase también addresses().

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

Establece el tipo de error de este ` QHostInfo ` como ` error`.

Véase también error() y errorString().

void QHostInfo::setErrorString(const QString &str)

Establece la descripción legible para el usuario del error que se ha producido en str si la búsqueda ha fallado.

Véase también errorString() y setError().

void QHostInfo::setHostName(const QString &hostName)

Establece el nombre de host de este QHostInfo en hostName.

Véase también hostName().

void QHostInfo::setLookupId(int id)

Establece el ID de esta consulta en id.

Véase también lookupId() y lookupHost().

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

Sustituye esta información del servidor por other. Esta operación es muy rápida y nunca falla.

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

La operación «Move-assigns» asigna other a esta instancia de QHostInfo.

Nota: El objeto del que se ha realizado el traslado, other, pasa a un estado parcialmente formado, en el que las únicas operaciones válidas son la destrucción y la asignación de un nuevo valor.

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

Asigna los datos del objeto « other » a este objeto de información del host y devuelve una referencia al mismo.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.