En esta página

QNetworkAddressEntry Class

La clase `QNetworkAddressEntry` almacena una dirección IP compatible con una interfaz de red, junto con la máscara de red y la dirección de difusión asociadas. Más información...

Cabecera: #include <QNetworkAddressEntry>
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.

Tipos públicos

enum DnsEligibilityStatus { DnsEligibilityUnknown, DnsEligible, DnsIneligible }

Funciones públicas

QNetworkAddressEntry()
QNetworkAddressEntry(const QNetworkAddressEntry &other)
~QNetworkAddressEntry()
QHostAddress broadcast() const
void clearAddressLifetime()
QNetworkAddressEntry::DnsEligibilityStatus dnsEligibility() const
QHostAddress ip() const
bool isLifetimeKnown() const
bool isPermanent() const
bool isTemporary() const
QHostAddress netmask() const
QDeadlineTimer preferredLifetime() const
int prefixLength() const
void setAddressLifetime(QDeadlineTimer preferred, QDeadlineTimer validity)
void setBroadcast(const QHostAddress &newBroadcast)
void setDnsEligibility(QNetworkAddressEntry::DnsEligibilityStatus status)
void setIp(const QHostAddress &newIp)
void setNetmask(const QHostAddress &newNetmask)
void setPrefixLength(int length)
void swap(QNetworkAddressEntry &other)
QDeadlineTimer validityLifetime() const
bool operator!=(const QNetworkAddressEntry &other) const
QNetworkAddressEntry &operator=(const QNetworkAddressEntry &other)
bool operator==(const QNetworkAddressEntry &other) const
(since 6.2) QDebug operator<<(QDebug debug, const QNetworkAddressEntry &entry)

Descripción detallada

Cada interfaz de red puede contener cero o más direcciones IP, que a su vez pueden estar asociadas a una máscara de red y/o a una dirección de difusión (dependiendo de la compatibilidad del sistema operativo).

Esta clase representa uno de estos grupos.

Documentación sobre los tipos de miembros

enum QNetworkAddressEntry::DnsEligibilityStatus

Esta enumeración indica si una dirección de host determinada es apta para su publicación en el Sistema de Nombres de Dominio (DNS) u otros mecanismos similares de resolución de nombres. En general, una dirección es apta para su publicación si se trata de una dirección a través de la cual se podrá acceder a este equipo durante un periodo de tiempo indeterminado, aunque no es necesario que sea permanente. Por ejemplo, las direcciones obtenidas a través de DHCP suelen ser aptas, pero las direcciones IPv6 temporales generadas criptográficamente no lo son.

ConstanteValorDescripción
QNetworkAddressEntry::DnsEligibilityUnknown-1Qt y el sistema operativo no han podido determinar si esta dirección debe publicarse o no. Es posible que la aplicación tenga que aplicar más reglas heurísticas si no encuentra ninguna dirección apta.
QNetworkAddressEntry::DnsEligible1Esta dirección es apta para su publicación en el DNS.
QNetworkAddressEntry::DnsIneligible0Esta dirección no debe publicarse en el DNS ni transmitirse a terceros, salvo quizá como dirección de origen de un paquete saliente.

Véase también dnsEligibility() y setDnsEligibility().

Documentación de las funciones miembro

QNetworkAddressEntry::QNetworkAddressEntry()

Crea un objeto `QNetworkAddressEntry` vacío.

QNetworkAddressEntry::QNetworkAddressEntry(const QNetworkAddressEntry &other)

Crea un objeto `QNetworkAddressEntry` que es una copia del objeto ` other`.

[noexcept] QNetworkAddressEntry::~QNetworkAddressEntry()

Elimina este objeto de tipo « QNetworkAddressEntry ».

QHostAddress QNetworkAddressEntry::broadcast() const

Devuelve la dirección de difusión asociada a la dirección IPv4 y a la máscara de red. Normalmente se puede obtener a partir de ambos valores estableciendo en 1 los bits de la dirección IP en los que la máscara de red contiene un 0. (En otras palabras, aplicando una operación OR bit a bit entre la dirección IP y el inverso de la máscara de red)

Este miembro siempre está vacío para las direcciones IPv6, ya que en ese sistema se ha abandonado el concepto de difusión en favor de la multidifusión. En concreto, se puede acceder al grupo de hosts correspondiente a todos los nodos de la red local mediante el grupo especial de multidifusión «todos los nodos» (dirección FF02::1).

Véase también setBroadcast().

void QNetworkAddressEntry::clearAddressLifetime()

Restablece tanto el tiempo de vida preferido como el válido para esta dirección. Tras esta llamada, la función ` isLifetimeKnown()` devolverá ` false`.

Véanse también preferredLifetime(), validityLifetime(), isLifetimeKnown() y setAddressLifetime().

QNetworkAddressEntry::DnsEligibilityStatus QNetworkAddressEntry::dnsEligibility() const

Indica si esta dirección es apta para su publicación en el Sistema de Nombres de Dominio (DNS) o en mecanismos similares de resolución de nombres.

En general, una dirección es apta para su publicación si es una dirección a través de la cual se podrá acceder a este equipo durante un tiempo indeterminado, aunque no es necesario que sea permanente. Por ejemplo, las direcciones obtenidas a través de DHCP suelen ser aptas, pero las direcciones IPv6 temporales generadas criptográficamente no lo son.

En algunos sistemas, QNetworkInterface tendrá que determinar de forma heurística qué direcciones son aptas.

Véanse también isLifetimeKnown(), isPermanent() y setDnsEligibility().

QHostAddress QNetworkAddressEntry::ip() const

Esta función devuelve una dirección IPv4 o IPv6 detectada en una interfaz de red.

Véase también setIp().

bool QNetworkAddressEntry::isLifetimeKnown() const

Devuelve « true » si se conoce la vida útil de la dirección, y « false » si no se conoce. Si no se conoce la vida útil, tanto « preferredLifetime()» como « validityLifetime()» devolverán « QDeadlineTimer::Forever ».

Véanse también preferredLifetime(), validityLifetime(), setAddressLifetime() y clearAddressLifetime().

bool QNetworkAddressEntry::isPermanent() const

Devuelve « true » si esta dirección es permanente en esta interfaz, y « false » si es temporal. Una dirección permanente es aquella que no tiene fecha de caducidad y suele ser estática (configurada manualmente).

Si no se ha podido determinar esta información, esta función devuelve « true ».

Nota: Dependiendo del sistema operativo y de la herramienta de configuración de red, es posible que una dirección temporal se interprete como permanente si la herramienta no ha comunicado correctamente los detalles al sistema operativo.

Véase también isLifetimeKnown(), validityLifetime() y isTemporary().

bool QNetworkAddressEntry::isTemporary() const

Devuelve « true » si esta dirección es temporal en esta interfaz, y « false » si es permanente.

Véase también isLifetimeKnown(), validityLifetime() y isPermanent().

QHostAddress QNetworkAddressEntry::netmask() const

Devuelve la máscara de red asociada a la dirección IP. La máscara de red se expresa en forma de dirección IP, como por ejemplo 255.255.0.0.

En el caso de las direcciones IPv6, la longitud del prefijo se convierte en una dirección en la que el número de bits establecidos en 1 es igual a la longitud del prefijo. Para una longitud de prefijo de 64 bits (el valor más habitual), la máscara de red se expresará como un QHostAddress que contenga la dirección FFFF:FFFF:FFFF:FFFF::

Véase también « setNetmask » () y « prefixLength » ().

QDeadlineTimer QNetworkAddressEntry::preferredLifetime() const

Devuelve la fecha límite en la que esta dirección quedará obsoleta (dejará de ser la preferida), si se conoce. Si se desconoce la vida útil de la dirección (véase isLifetimeKnown()), esta función siempre devuelve QDeadlineTimer::Forever.

Mientras una dirección sea preferida, el sistema operativo podrá utilizarla como dirección de origen para los nuevos paquetes salientes. Una vez que quede obsoleta, seguirá siendo válida para los paquetes entrantes durante un tiempo más, hasta que finalmente se elimine (véase validityLifetime()).

Véase también validityLifetime(), isLifetimeKnown(), setAddressLifetime() y clearAddressLifetime().

int QNetworkAddressEntry::prefixLength() const

Devuelve la longitud del prefijo de esta dirección IP. La longitud del prefijo coincide con el número de bits establecidos en 1 en la máscara de red (véase netmask()). Para las direcciones IPv4, el valor está comprendido entre 0 y 32. Para las direcciones IPv6, está comprendido entre 0 y 128 y es la forma preferida de representar las direcciones.

Esta función devuelve -1 si no se ha podido determinar la longitud del prefijo (es decir, netmask() devuelve un QHostAddress() nulo).

Véase también setPrefixLength() y netmask().

void QNetworkAddressEntry::setAddressLifetime(QDeadlineTimer preferred, QDeadlineTimer validity)

Establece tanto el tiempo de vida preferido como el válido para esta dirección en los plazos de preferred y validity, respectivamente. Tras esta llamada, isLifetimeKnown() devolverá true, incluso si ambos parámetros son QDeadlineTimer::Forever.

Véase también preferredLifetime(), validityLifetime(), isLifetimeKnown() y clearAddressLifetime().

void QNetworkAddressEntry::setBroadcast(const QHostAddress &newBroadcast)

Establece la dirección IP de difusión de este objeto QNetworkAddressEntry en newBroadcast.

Véase también broadcast().

void QNetworkAddressEntry::setDnsEligibility(QNetworkAddressEntry::DnsEligibilityStatus status)

Establece el indicador de elegibilidad de DNS para esta dirección en « status ».

Véase también dnsEligibility().

void QNetworkAddressEntry::setIp(const QHostAddress &newIp)

Establece la dirección IP que contiene el objeto ` QNetworkAddressEntry ` en ` newIp`.

Véase también ip().

void QNetworkAddressEntry::setNetmask(const QHostAddress &newNetmask)

Establece la máscara de red que contiene este objeto ` QNetworkAddressEntry ` en ` newNetmask`. Al establecer la máscara de red, también se ajusta la longitud del prefijo para que coincida con la nueva máscara de red.

Véase también netmask() y setPrefixLength().

void QNetworkAddressEntry::setPrefixLength(int length)

Establece la longitud del prefijo de esta dirección IP en length. El valor de length debe ser válido para este tipo de dirección IP: entre 0 y 32 para direcciones IPv4, y entre 0 y 128 para direcciones IPv6. Establecer cualquier valor no válido equivale a establecerlo en -1, lo que significa «sin longitud de prefijo».

Al establecer la longitud del prefijo, también se establece la máscara de red (véase netmask()).

Véase también prefixLength() y setNetmask().

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

Sustituye esta instancia de entrada de dirección de red por other. Esta operación es muy rápida y nunca falla.

QDeadlineTimer QNetworkAddressEntry::validityLifetime() const

Devuelve la fecha límite en la que esta dirección dejará de ser válida y será eliminada de la pila de red, si se conoce. Si se desconoce la vida útil de la dirección (véase isLifetimeKnown()), esta función siempre devuelve QDeadlineTimer::Forever.

Mientras una dirección sea válida, el sistema operativo la aceptará como dirección de destino válida para este equipo. El hecho de que se utilice como dirección de origen para nuevos paquetes salientes viene determinado, entre otras reglas, por la vida útil preferida (véase preferredLifetime()).

Véanse también preferredLifetime(), isLifetimeKnown(), setAddressLifetime() y clearAddressLifetime().

bool QNetworkAddressEntry::operator!=(const QNetworkAddressEntry &other) const

Devuelve « true » si esta entrada de dirección de red es diferente de « other ».

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

Crea una copia del objeto « QNetworkAddressEntry » other.

bool QNetworkAddressEntry::operator==(const QNetworkAddressEntry &other) const

Devuelve « true » si esta entrada de dirección de red coincide con « other ».

No miembros relacionados

[since 6.2] QDebug operator<<(QDebug debug, const QNetworkAddressEntry &entry)

Escribe el archivo QNetworkAddressEntry entry en el flujo y devuelve una referencia al flujo debug.

Esta función se introdujo en Qt 6.2.

© 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.