QHostAddress Class
La clase QHostAddress proporciona una dirección IP. Más información...
| Encabezado: | #include <QHostAddress> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Network) target_link_libraries(mytarget PRIVATE Qt6::Network) |
| qmake: | QT += network |
- Lista de todos los miembros, incluidos los heredados
- QHostAddress forma parte de la API de programación de redes y de las clases compartidas implícitamente.
Tipos públicos
| flags | ConversionMode |
| enum | ConversionModeFlag { StrictConversion, ConvertV4MappedToIPv4, ConvertV4CompatToIPv4, ConvertLocalHost, ConvertUnspecifiedAddress, TolerantConversion } |
| enum | SpecialAddress { Null, LocalHost, LocalHostIPv6, Broadcast, AnyIPv4, …, Any } |
Funciones públicas
| QHostAddress() | |
| QHostAddress(QHostAddress::SpecialAddress address) | |
| QHostAddress(const QString &address) | |
| QHostAddress(const Q_IPV6ADDR &ip6Addr) | |
| QHostAddress(const quint8 *ip6Addr) | |
| QHostAddress(const sockaddr *sockaddr) | |
| QHostAddress(quint32 ip4Addr) | |
| QHostAddress(const QHostAddress &address) | |
(since 6.8) | QHostAddress(QHostAddress &&other) |
| ~QHostAddress() | |
| void | clear() |
| bool | isBroadcast() const |
| bool | isEqual(const QHostAddress &other, QHostAddress::ConversionMode mode = TolerantConversion) const |
| bool | isGlobal() const |
| bool | isInSubnet(const QHostAddress &subnet, int netmask) const |
| bool | isInSubnet(const std::pair<QHostAddress, int> &subnet) const |
| bool | isLinkLocal() const |
| bool | isLoopback() const |
| bool | isMulticast() const |
| bool | isNull() const |
(since 6.6) bool | isPrivateUse() const |
| bool | isSiteLocal() const |
| bool | isUniqueLocalUnicast() const |
| int | protocol() const |
| QString | scopeId() const |
| void | setAddress(quint32 ip4Addr) |
| void | setAddress(QHostAddress::SpecialAddress address) |
| bool | setAddress(const QString &address) |
| void | setAddress(const Q_IPV6ADDR &ip6Addr) |
| void | setAddress(const quint8 *ip6Addr) |
| void | setAddress(const sockaddr *sockaddr) |
| void | setScopeId(const QString &id) |
| void | swap(QHostAddress &other) |
| quint32 | toIPv4Address(bool *ok = nullptr) const |
| Q_IPV6ADDR | toIPv6Address() const |
| QString | toString() const |
| bool | operator!=(QHostAddress::SpecialAddress other) const |
| bool | operator!=(const QHostAddress &other) const |
| QHostAddress & | operator=(QHostAddress::SpecialAddress address) |
| QHostAddress & | operator=(const QHostAddress &address) |
| bool | operator==(QHostAddress::SpecialAddress other) const |
| bool | operator==(const QHostAddress &other) const |
Miembros públicos estáticos
| std::pair<QHostAddress, int> | parseSubnet(const QString &subnet) |
Elementos no miembros relacionados
| size_t | qHash(const QHostAddress &key, size_t seed = 0) |
| bool | operator!=(QHostAddress::SpecialAddress lhs, const QHostAddress &rhs) |
| QDataStream & | operator<<(QDataStream &out, const QHostAddress &address) |
| bool | operator==(QHostAddress::SpecialAddress lhs, const QHostAddress &rhs) |
| QDataStream & | operator>>(QDataStream &in, QHostAddress &address) |
Descripción detallada
Esta clase almacena una dirección IPv4 o IPv6 de forma independiente de la plataforma y del protocolo.
QHostAddress se utiliza normalmente con las funciones QTcpSocket, QTcpServer y QUdpSocket para conectarse a un host o configurar un servidor.
Una dirección de host se establece con ` setAddress()`, y se recupera con ` toIPv4Address()`, ` toIPv6Address()` o ` toString()`. Se puede comprobar el tipo con ` protocol()`.
Nota: Ten en cuenta que QHostAddress no realiza búsquedas DNS. Para ello se necesita QHostInfo.
La clase también admite direcciones predefinidas comunes: Null, LocalHost, LocalHostIPv6, Broadcast y Any.
Véase también QHostInfo, QTcpSocket, QTcpServer y QUdpSocket.
Documentación sobre tipos de miembros
enum QHostAddress::ConversionModeFlag
flags QHostAddress::ConversionMode
| Constante | Valor | Descripción |
|---|---|---|
QHostAddress::StrictConversion | 0 | No convertir las direcciones IPv6 a IPv4 al comparar dos objetos ` QHostAddress ` de protocolos diferentes, de modo que siempre se consideren distintos. |
QHostAddress::ConvertV4MappedToIPv4 | 1 | Convierte las direcciones IPv6 mapeadas a IPv4 (RFC 4291, sección 2.5.5.2) al compararlas. Por lo tanto, QHostAddress(«::ffff:192.168.1.1») se considerará igual a QHostAddress(«192.168.1.1»). |
QHostAddress::ConvertV4CompatToIPv4 | 2 | Convertir las direcciones IPv6 compatibles con IPv4 (RFC 4291, sección 2.5.5.1) al realizar la comparación. Por lo tanto, QHostAddress(«::192.168.1.1») se considerará igual a QHostAddress(«192.168.1.1»). |
QHostAddress::ConvertLocalHost | 8 | Convertir las direcciones de bucle cerrado de IPv6 a su equivalente en IPv4 al realizar la comparación. Por lo tanto, por ejemplo, QHostAddress(«::1») se considerará igual a QHostAddress(«127.0.0.1»). |
QHostAddress::ConvertUnspecifiedAddress | 4 | Todas las direcciones no especificadas se considerarán iguales, es decir, AnyIPv4, AnyIPv6 y Any. |
QHostAddress::TolerantConversion | 0xff | Establece los tres indicadores anteriores. |
El tipo ConversionMode es un typedef de QFlags<ConversionModeFlag>. Almacena una combinación OR de valores de ConversionModeFlag.
Véase también isEqual().
enum QHostAddress::SpecialAddress
| Constante | Valor | Descripción |
|---|---|---|
QHostAddress::Null | 0 | El objeto de dirección nula. Equivalente a QHostAddress(). Véase también QHostAddress::isNull(). |
QHostAddress::LocalHost | 2 | La dirección localhost de IPv4. Equivalente a QHostAddress(«127.0.0.1»). |
QHostAddress::LocalHostIPv6 | 3 | La dirección de localhost de IPv6. Equivalente a QHostAddress(«::1»). |
QHostAddress::Broadcast | 1 | La dirección de difusión de IPv4. Equivalente a QHostAddress(«255.255.255.255»). |
QHostAddress::AnyIPv4 | 6 | La dirección «cualquier dirección» de IPv4. Equivalente a QHostAddress(«0.0.0.0»). Un socket vinculado a esta dirección escuchará únicamente en interfaces IPv4. |
QHostAddress::AnyIPv6 | 5 | La dirección «cualquier dirección» de IPv6. Equivalente a QHostAddress(«::»). Un socket vinculado a esta dirección escuchará únicamente en interfaces IPv6. |
QHostAddress::Any | 4 | La dirección genérica de pila dual. Un socket vinculado a esta dirección escuchará tanto en interfaces IPv4 como IPv6. |
Documentación de las funciones miembro
QHostAddress::QHostAddress()
Crea un objeto de dirección de host nula, es decir, una dirección que no es válida para ningún host ni interfaz.
Véase también ` clear()`.
QHostAddress::QHostAddress(QHostAddress::SpecialAddress address)
Crea un objeto QHostAddress para address.
[explicit] QHostAddress::QHostAddress(const QString &address)
Crea una dirección IPv4 o IPv6 a partir de la cadena « address » (por ejemplo, «127.0.0.1»).
Véase también setAddress().
[explicit] QHostAddress::QHostAddress(const Q_IPV6ADDR &ip6Addr)
Crea un objeto de dirección de host con la dirección IPv6 ip6Addr.
[explicit] QHostAddress::QHostAddress(const quint8 *ip6Addr)
Crea un objeto de dirección de host con la dirección IPv6 ip6Addr.
ip6Addr Debe ser una matriz de 16 bytes en orden de bytes de red (big endian).
[explicit] QHostAddress::QHostAddress(const sockaddr *sockaddr)
Crea una dirección IPv4 o IPv6 utilizando la dirección especificada por la estructura nativa ` sockaddr`.
Véase también setAddress().
[explicit] QHostAddress::QHostAddress(quint32 ip4Addr)
Crea un objeto de dirección de host con la dirección IPv4 ip4Addr.
QHostAddress::QHostAddress(const QHostAddress &address)
Crea una copia del objeto ` address` indicado.
[constexpr noexcept default, since 6.8] QHostAddress::QHostAddress(QHostAddress &&other)
Crea un nuevo objeto `QHostAddress` a partir de ` other`.
Nota: El objeto del que se ha realizado el movimiento, ` other `, queda en un estado parcialmente formado, en el que las únicas operaciones válidas son la destrucción y la asignación de un nuevo valor.
Esta función se introdujo en Qt 6.8.
[noexcept] QHostAddress::~QHostAddress()
Elimina el objeto de dirección del host.
void QHostAddress::clear()
Establece la dirección del host en nulo y el protocolo en QAbstractSocket::UnknownNetworkLayerProtocol.
Véase también QHostAddress::Null.
bool QHostAddress::isBroadcast() const
Devuelve « true » si la dirección es la dirección de difusión IPv4; en caso contrario, devuelve « false ». La dirección de difusión IPv4 es 255.255.255.255.
Ten en cuenta que esta función no devuelve «true» para la dirección de difusión local de una red IPv4. Para ello, utiliza QNetworkInterface para obtener las direcciones de difusión del equipo local.
Véanse también isLoopback(), isGlobal(), isMulticast(), isLinkLocal(), isUniqueLocalUnicast() y isPrivateUse().
bool QHostAddress::isEqual(const QHostAddress &other, QHostAddress::ConversionMode mode = TolerantConversion) const
Devuelve « true » si esta dirección de host coincide con la dirección « other » indicada; en caso contrario, devuelve « false ».
El parámetro mode controla qué conversiones se realizan entre direcciones de protocolos diferentes. Si no se especifica ningún mode, se realiza TolerantConversion de forma predeterminada.
Véanse también ConversionMode y operator==().
bool QHostAddress::isGlobal() const
Devuelve ` true ` si la dirección es una dirección global IPv4 o IPv6; en caso contrario, devuelve ` false `. Una dirección global es aquella que no está reservada para fines especiales (como el bucle de retorno o la multidifusión) ni para usos futuros.
Ten en cuenta que las direcciones de unidifusión locales únicas de IPv6 se consideran direcciones globales (véase isUniqueLocalUnicast()), al igual que las direcciones IPv4 reservadas para redes locales según la RFC 1918.
Tenga en cuenta también que las direcciones locales de sitio de IPv6 están en desuso y deben considerarse globales en las nuevas aplicaciones. Esta función devuelve «true» también para las direcciones locales de sitio.
Véanse también isLoopback(), isSiteLocal(), isUniqueLocalUnicast() y isPrivateUse().
bool QHostAddress::isInSubnet(const QHostAddress &subnet, int netmask) const
Devuelve « true » si esta dirección IP se encuentra en la subred descrita por el prefijo de red « subnet » y la máscara de red « netmask ».
El parámetro netmask es la longitud del prefijo: el número de bits iniciales que se utilizan para identificar la parte de red de la dirección. Para IPv4, los valores válidos van de 0 a 32; para IPv6, de 0 a 128.
Se considera que una dirección IP pertenece a una subred si se encuentra comprendida entre la dirección más baja y la más alta de dicha subred. En el caso de la versión 4 de IP, la dirección más baja es la dirección de red, mientras que la más alta es la dirección de difusión.
El argumento subnet no tiene por qué ser la dirección de red real (la dirección más baja de la subred). Puede ser cualquier dirección IP válida que pertenezca a esa subred. En particular, si es igual a la dirección IP que contiene este objeto, esta función siempre devolverá «true» (siempre que la longitud del prefijo sea un valor válido).
Véase también parseSubnet().
bool QHostAddress::isInSubnet(const std::pair<QHostAddress, int> &subnet) const
Devuelve ` true ` si esta dirección IP se encuentra en la subred descrita por ` subnet`. El miembro ` QHostAddress ` de ` subnet ` contiene el prefijo de red y el miembro `int` (segundo) contiene la máscara de red (longitud del prefijo).
Se trata de una función sobrecargada.
bool QHostAddress::isLinkLocal() const
Devuelve « true » si la dirección es una dirección de enlace local IPv4 o IPv6; en caso contrario, devuelve « false ».
Una dirección local de enlace IPv4 es una dirección de la red 169.254.0.0/16. Una dirección local de enlace IPv6 es una dirección de la red fe80::/10. Consulte el registro del espacio de direcciones IPv6 de la IANA para obtener más información.
Véanse también isLoopback(), isGlobal(), isMulticast(), isSiteLocal(), isUniqueLocalUnicast() y isPrivateUse().
bool QHostAddress::isLoopback() const
devuelve « true » si la dirección es la dirección de bucle cerrado de IPv6 o cualquiera de las direcciones de bucle cerrado de IPv4.
bool QHostAddress::isMulticast() const
Devuelve « true » si la dirección es una dirección de multidifusión IPv4 o IPv6; en caso contrario, devuelve « false ».
Véase también isLoopback(), isGlobal(), isLinkLocal(), isSiteLocal(), isUniqueLocalUnicast() y isPrivateUse().
bool QHostAddress::isNull() const
Devuelve « true » si esta dirección de host no es válida para ningún host ni interfaz.
El constructor por defecto crea una dirección nula.
Véase también QHostAddress::Null.
[since 6.6] bool QHostAddress::isPrivateUse() const
Devuelve ` true ` si la dirección es una dirección de unidifusión local única de IPv6 o una dirección IPv4 reservada para redes locales según el RFC 1918; en caso contrario, devuelve ` false `.
Esta función se introdujo en Qt 6.6.
Véase también isLoopback(), isGlobal(), isMulticast(), isLinkLocal(), isUniqueLocalUnicast() y isBroadcast().
bool QHostAddress::isSiteLocal() const
Devuelve « true » si la dirección es una dirección local de sitio IPv6; en caso contrario, devuelve « false ».
Una dirección IPv6 local del sitio es aquella que pertenece a la red fec0::/10. Consulte el registro del espacio de direcciones IPv6 de la IANA para obtener más información.
Las direcciones locales de sitio IPv6 están obsoletas y no se debe depender de ellas en las nuevas aplicaciones. Las nuevas aplicaciones no deben depender de esta función y deben considerar las direcciones locales de sitio como si fueran globales (por eso isGlobal() también devuelve «true»). Las direcciones locales de sitio fueron sustituidas por las direcciones locales únicas (ULA).
Véanse también isLoopback(), isGlobal(), isMulticast(), isLinkLocal(), isUniqueLocalUnicast() y isPrivateUse().
bool QHostAddress::isUniqueLocalUnicast() const
Devuelve ` true ` si la dirección es una dirección de unidifusión local única de IPv6; en caso contrario, devuelve ` false `.
Una dirección de unidifusión local única de IPv6 es aquella que pertenece a la red fc00::/7. Consulte el registro del espacio de direcciones IPv6 de la IANA para obtener más información.
Ten en cuenta que las direcciones de unidifusión locales únicas también se consideran direcciones globales. El RFC 4193 establece que, en la práctica, «las aplicaciones pueden tratar estas direcciones como direcciones de ámbito global». Solo los enrutadores deben tener en cuenta esta distinción.
Véase también isLoopback(), isGlobal(), isMulticast(), isLinkLocal() y isPrivateUse().
[static] std::pair<QHostAddress, int> QHostAddress::parseSubnet(const QString &subnet)
Analiza la información de IP y subred contenida en subnet y devuelve el prefijo de red correspondiente a esa red y la longitud de dicho prefijo.
La dirección IP y la máscara de red deben estar separadas por una barra (/).
Esta función admite argumentos con el formato:
- 123.123.123.123/n, donde n es cualquier valor entre 0 y 32
- 123.123.123.123/255.255.255.255
- <dirección-ipv6>/n, donde n es cualquier valor entre 0 y 128
En el caso de la versión 4 de IP, esta función también admite componentes finales omitidos (es decir, menos de 4 octetos, como «192.168.1»), seguidos o no de un punto. Si en ese caso también falta la máscara de red, se establece en el número de octetos realmente pasados (en el ejemplo anterior, sería 24, para 3 octetos).
Véase también isInSubnet().
int QHostAddress::protocol() const
Devuelve el protocolo de la capa de red de la dirección del host.
QString QHostAddress::scopeId() const
Devuelve el identificador de ámbito de una dirección IPv6. En el caso de las direcciones IPv4, o si la dirección no contiene un identificador de ámbito, se devuelve un objeto « QString » vacío.
El identificador de ámbito IPv6 especifica el ámbito de accesibilidad de las direcciones IPv6 no globales, lo que limita el área en la que se puede utilizar la dirección. Todas las direcciones IPv6 están asociadas a dicho ámbito de accesibilidad. El identificador de ámbito se utiliza para eliminar la ambigüedad en direcciones cuya unicidad global no está garantizada.
IPv6 especifica los cuatro niveles de accesibilidad siguientes:
- Local al nodo: direcciones que solo se utilizan para comunicarse con servicios en la misma interfaz (por ejemplo, la interfaz de bucle invertido «::1»).
- Local de enlace: direcciones que son locales a la interfaz de red (enlace). Siempre hay una dirección local de enlace para cada interfaz IPv6 de su host. Las direcciones locales de enlace («fe80...») se generan a partir de la dirección MAC del adaptador de red local y no se garantiza que sean únicas.
- Global: para direcciones enrutables a nivel global, como los servidores públicos de Internet.
Al utilizar una dirección de enlace local o de sitio local para conexiones IPv6, debes especificar el identificador de ámbito. El identificador de ámbito de una dirección local de enlace suele ser el mismo que el nombre de la interfaz (p. ej., «eth0», «en1») o su número (p. ej., «1», «2»).
Véase también setScopeId(), QNetworkInterface y QNetworkInterface::interfaceFromName.
void QHostAddress::setAddress(quint32 ip4Addr)
Establece la dirección IPv4 especificada en ip4Addr.
void QHostAddress::setAddress(QHostAddress::SpecialAddress address)
Establece la dirección especial especificada por ` address`.
Esta es una función sobrecargada.
bool QHostAddress::setAddress(const QString &address)
Establece la dirección IPv4 o IPv6 especificada mediante la representación en cadena indicada por ` address ` (por ejemplo, «127.0.0.1»). Devuelve ` true ` y establece la dirección si esta se ha analizado correctamente; en caso contrario, devuelve ` false`.
Se trata de una función sobrecargada.
void QHostAddress::setAddress(const Q_IPV6ADDR &ip6Addr)
Establece la dirección IPv6 especificada en ip6Addr.
Esta es una función sobrecargada.
void QHostAddress::setAddress(const quint8 *ip6Addr)
Establece la dirección IPv6 especificada en ` ip6Addr`.
ip6Addr Debe ser una matriz de 16 bytes en orden de bytes de red (el byte de orden superior primero).
Esta es una función sobrecargada.
void QHostAddress::setAddress(const sockaddr *sockaddr)
Establece la dirección IPv4 o IPv6 especificada por la estructura nativa ` sockaddr`. Devuelve ` true ` y establece la dirección si esta se ha analizado correctamente; en caso contrario, devuelve ` false`.
Esta es una función sobrecargada.
void QHostAddress::setScopeId(const QString &id)
Establece el identificador de ámbito IPv6 de la dirección en « id ». Si el protocolo de la dirección no es IPv6, esta función no realiza ninguna acción. El identificador de ámbito puede establecerse como un nombre de interfaz (como «eth0» o «en1») o como un número entero que represente el índice de la interfaz. Si id es un nombre de interfaz, QtNetwork lo convertirá en un índice de interfaz utilizando QNetworkInterface::interfaceIndexFromName() antes de llamar a las funciones de red del sistema operativo.
Véanse también scopeId(), QNetworkInterface y QNetworkInterface::interfaceFromName.
[noexcept] void QHostAddress::swap(QHostAddress &other)
Intercambia esta dirección de host por other. Esta operación es muy rápida y nunca falla.
quint32 QHostAddress::toIPv4Address(bool *ok = nullptr) const
Devuelve la dirección IPv4 en forma de número.
Por ejemplo, si la dirección es 127.0.0.1, el valor devuelto es 2130706433 (es decir, 0x7f000001).
Este valor es válido si la función « protocol()» devuelve « IPv4Protocol », o si el protocolo es « IPv6Protocol » y la dirección IPv6 es una dirección mapeada a IPv4 (RFC4291). En esos casos, « ok » se establecerá en «true». En caso contrario, se establecerá en «false».
Véase también toString().
Q_IPV6ADDR QHostAddress::toIPv6Address() const
Devuelve la dirección IPv6 como una estructura Q_IPV6ADDR. La estructura consta de 16 caracteres sin signo.
Q_IPV6ADDR addr = hostAddr.toIPv6Address();
// addr contains 16 unsigned characters
for (int i = 0; i < 16; ++i) {
// process addr[i]
}Este valor es válido si la función ` protocol()` devuelve ` IPv6Protocol`. Si el protocolo es ` IPv4Protocol`, la dirección se devuelve como una dirección IPv6 mapeada a IPv4. (RFC4291)
Véase también toString().
QString QHostAddress::toString() const
Devuelve la dirección como una cadena de caracteres.
Por ejemplo, si la dirección es la dirección IPv4 127.0.0.1, la cadena devuelta será «127.0.0.1». En el caso de IPv6, el formato de la cadena seguirá la recomendación RFC 5952. Para QHostAddress::Any, se devolverá su dirección IPv4 («0.0.0.0»).
Véase también toIPv4Address().
bool QHostAddress::operator!=(QHostAddress::SpecialAddress other) const
Devuelve « true » si esta dirección de host no coincide con la dirección « other » indicada; en caso contrario, devuelve « false ».
bool QHostAddress::operator!=(const QHostAddress &other) const
Devuelve « true » si esta dirección de host no coincide con la dirección « other » indicada; en caso contrario, devuelve « false ».
QHostAddress &QHostAddress::operator=(QHostAddress::SpecialAddress address)
Asigna la dirección especial address a este objeto y devuelve una referencia a este objeto.
Véase también setAddress().
QHostAddress &QHostAddress::operator=(const QHostAddress &address)
Asigna otro host address a este objeto y devuelve una referencia a este objeto.
bool QHostAddress::operator==(QHostAddress::SpecialAddress other) const
Devuelve « true » si esta dirección de host coincide con la dirección « other » indicada; en caso contrario, devuelve « false ».
bool QHostAddress::operator==(const QHostAddress &other) const
Devuelve « true » si esta dirección de host es la misma que la dirección « other » proporcionada; en caso contrario, devuelve « false ». Este operador simplemente llama a « isEqual » (véase también « StrictConversion »).
Véase también isEqual().
Elementos no miembros relacionados
[noexcept] size_t qHash(const QHostAddress &key, size_t seed = 0)
Devuelve el valor hash de key, utilizando seed como semilla para el cálculo.
bool operator!=(QHostAddress::SpecialAddress lhs, const QHostAddress &rhs)
Devuelve « false » si la dirección especial lhs coincide con la dirección del servidor rhs; en caso contrario, devuelve « true ».
Véase también isEqual().
QDataStream &operator<<(QDataStream &out, const QHostAddress &address)
Escribe la dirección del host address en el flujo out y devuelve una referencia al flujo.
Véase también «Serialización detipos de datos de Qt».
bool operator==(QHostAddress::SpecialAddress lhs, const QHostAddress &rhs)
Devuelve « true » si la dirección especial lhs coincide con la dirección del servidor rhs; en caso contrario, devuelve « false ».
Véase también isEqual().
QDataStream &operator>>(QDataStream &in, QHostAddress &address)
Lee una dirección de host en ` address ` desde el flujo ` in ` y devuelve una referencia al flujo.
Véase también «Serialización detipos de datos de Qt».
© 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.