QNetworkInterface Class
La clase QNetworkInterface proporciona una lista de las direcciones IP y las interfaces de red del host. Más información...
| Encabezado: | #include <QNetworkInterface> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Network) target_link_libraries(mytarget PRIVATE Qt6::Network) |
| qmake: | QT += network |
- Lista de todos los miembros, incluidos los miembros heredados
- QNetworkInterface forma parte de la API de programación de redes y de las clases compartidas implícitamente.
Nota: Todas las funciones de esta clase son reentrantes.
Tipos públicos
| enum | InterfaceFlag { IsUp, IsRunning, CanBroadcast, IsLoopBack, IsPointToPoint, CanMulticast } |
| flags | InterfaceFlags |
| enum | InterfaceType { Unknown, Loopback, Virtual, Ethernet, Wifi, …, Ieee1394 } |
Funciones públicas
| QNetworkInterface() | |
| QNetworkInterface(const QNetworkInterface &other) | |
| ~QNetworkInterface() | |
| QList<QNetworkAddressEntry> | addressEntries() const |
| QNetworkInterface::InterfaceFlags | flags() const |
| QString | hardwareAddress() const |
| QString | humanReadableName() const |
| int | index() const |
| bool | isValid() const |
| int | maximumTransmissionUnit() const |
| QString | name() const |
| void | swap(QNetworkInterface &other) |
| QNetworkInterface::InterfaceType | type() const |
| QNetworkInterface & | operator=(const QNetworkInterface &other) |
Miembros públicos estáticos
| QList<QHostAddress> | allAddresses() |
| QList<QNetworkInterface> | allInterfaces() |
| QNetworkInterface | interfaceFromIndex(int index) |
| QNetworkInterface | interfaceFromName(const QString &name) |
| int | interfaceIndexFromName(const QString &name) |
| QString | interfaceNameFromIndex(int index) |
Elementos no miembros relacionados
| QDebug | operator<<(QDebug debug, const QNetworkInterface &networkInterface) |
Descripción detallada
QNetworkInterface representa una interfaz de red conectada al host en el que se ejecuta el programa. Cada interfaz de red puede contener cero o más direcciones IP, cada una de las cuales puede estar asociada opcionalmente a una máscara de red y/o a una dirección de difusión. La lista de dichos tríos se puede obtener con ` addressEntries()`. Alternativamente, cuando no se necesiten la máscara de red, las direcciones de difusión u otra información, utilice la función de conveniencia ` allAddresses()` para obtener únicamente las direcciones IP de las interfaces activas.
QNetworkInterface también proporciona la dirección de hardware de la interfaz mediante hardwareAddress().
No todos los sistemas operativos admiten la obtención de todas las características. Solo se garantiza que esta clase muestre las direcciones IPv4 en todas las plataformas. En concreto, la lista de direcciones IPv6 solo es compatible con Windows, Linux, macOS y los sistemas BSD. Del mismo modo, es posible que el tipo de interfaz que proporciona type() no esté disponible en todas las plataformas.
Nota: En Android, el tipo de interfaz siempre se indica como « Unknown », ya que la plataforma no expone información sobre el tipo de hardware de las interfaces físicas.
Véase también QNetworkAddressEntry.
Documentación sobre los tipos de miembros
enum QNetworkInterface::InterfaceFlag
flags QNetworkInterface::InterfaceFlags
Especifica los indicadores asociados a esta interfaz de red. Los valores posibles son:
| Constante | Valor | Descripción |
|---|---|---|
QNetworkInterface::IsUp | 0x1 | la interfaz de red está «activa» —habilitada mediante una acción administrativa— |
QNetworkInterface::IsRunning | 0x2 | la interfaz de red está operativa: configurada como «activa» y (normalmente) conectada físicamente a una red |
QNetworkInterface::CanBroadcast | 0x4 | la interfaz de red funciona en modo de difusión |
QNetworkInterface::IsLoopBack | 0x8 | la interfaz de red es una interfaz de bucle cerrado: es decir, es una interfaz virtual cuyo destino es el propio ordenador anfitrión |
QNetworkInterface::IsPointToPoint | 0x10 | la interfaz de red es una interfaz punto a punto: es decir, hay una única dirección a la que puede acceder directamente. |
QNetworkInterface::CanMulticast | 0x20 | La interfaz de red admite multidifusión |
Ten en cuenta que una interfaz de red no puede ser a la vez de difusión y punto a punto.
El tipo InterfaceFlags es un typedef para QFlags<InterfaceFlag>. Almacena una combinación OR de valores de InterfaceFlag.
enum QNetworkInterface::InterfaceType
Especifica el tipo de hardware (capa PHY, nivel 1 del modelo OSI) de esta interfaz, siempre que sea posible determinarlo. Los tipos de interfaz que no figuren entre los que se enumeran a continuación aparecerán, por lo general, como «Desconocido», aunque es posible que en futuras versiones de Qt se añadan nuevos valores de enumeración.
Los valores posibles son:
| Constante | Valor | Descripción |
|---|---|---|
QNetworkInterface::Unknown | 0 | No se ha podido determinar el tipo de interfaz o no corresponde a ninguno de los tipos enumerados. |
QNetworkInterface::Loopback | 1 | La interfaz de bucle invertido virtual, a la que se asignan las direcciones IP de bucle invertido (127.0.0.1, ::1). |
QNetworkInterface::Virtual | 2 | Un tipo de interfaz que se ha determinado que es virtual, pero que no corresponde a ninguno de los demás tipos posibles. Por ejemplo, las interfaces de túnel se detectan (actualmente) como virtuales. |
QNetworkInterface::Ethernet | 3 | Interfaces Ethernet IEEE 802.3, aunque en muchos sistemas también pueden detectarse como Ethernet otros tipos de interfaces IEEE 802 (especialmente Wi-Fi). |
QNetworkInterface::Wifi | 8 | Interfaces Wi-Fi IEEE 802.11. Ten en cuenta que, en algunos sistemas, es posible que « QNetworkInterface » no pueda distinguir entre Ethernet convencional y Wi-Fi y, por lo tanto, no devuelva este valor de enumeración. |
QNetworkInterface::Ieee80211 | Wifi | Un alias para Wi-Fi. |
QNetworkInterface::CanBus | 5 | Interfaces de bus de red de área de controlador (CAN) ISO 11898, que suelen encontrarse en sistemas de automoción. |
QNetworkInterface::Fddi | 7 | Interfaz de datos distribuidos por fibra (FDD) ANSI X3T12, una red de área local a través de fibras ópticas. |
QNetworkInterface::Ppp | 6 | Interfaces de Protocolo punto a punto (PPP), que establecen una conexión directa entre dos nodos a través de una capa de transporte inferior (a menudo serie por radio o línea física). |
QNetworkInterface::Slip | 4 | Interfaces del Protocolo de Internet por línea serie. |
QNetworkInterface::Phonet | 9 | Interfaces que utilizan la familia de sockets Phonet de Linux, para la comunicación con módems móviles. Consulta la documentación del núcleo de Linux para obtener más información. |
QNetworkInterface::Ieee802154 | 10 | Interfaces de red de área personal (PAN) IEEE 802.15.4, distintas de 6LoWPAN (véase más abajo). |
QNetworkInterface::SixLoWPAN | 11 | Interfaces 6LoWPAN (IPv6 sobre redes de área personal inalámbricas de baja potencia), que funcionan con la capa física (PHY) del estándar IEEE 802.15.4, pero cuentan con esquemas específicos de compresión de encabezados para IPv6 y UDP. Este tipo de interfaz se utiliza a menudo para redes en malla. |
QNetworkInterface::Ieee80216 | 12 | Red de área metropolitana inalámbrica IEEE 802.16, también conocida con el nombre comercial «WiMAX». |
QNetworkInterface::Ieee1394 | 13 | Interfaces IEEE 1394 (también conocidas como «FireWire»). |
Documentación de las funciones de los miembros
QNetworkInterface::QNetworkInterface()
Crea un objeto de interfaz de red vacío.
QNetworkInterface::QNetworkInterface(const QNetworkInterface &other)
Crea una copia del objeto `QNetworkInterface` que se encuentra en ` other`.
[noexcept] QNetworkInterface::~QNetworkInterface()
Libera los recursos asociados al objeto ` QNetworkInterface `.
QList<QNetworkAddressEntry> QNetworkInterface::addressEntries() const
Devuelve la lista de direcciones IP que posee esta interfaz, junto con sus máscaras de red y direcciones de difusión asociadas.
Si no se necesita la máscara de red, la dirección de difusión u otra información, se puede llamar a la función ` allAddresses()` para obtener únicamente las direcciones IP de las interfaces activas.
[static] QList<QHostAddress> QNetworkInterface::allAddresses()
Esta función de conveniencia devuelve todas las direcciones IP encontradas en el equipo local. Equivale a llamar a ` addressEntries()` sobre todos los objetos devueltos por ` allInterfaces()` que se encuentren en el estado « QNetworkInterface::IsUp » para obtener listas de objetos ` QNetworkAddressEntry ` y, a continuación, llamar a ` QNetworkAddressEntry::ip()` sobre cada uno de ellos.
[static] QList<QNetworkInterface> QNetworkInterface::allInterfaces()
Devuelve una lista de todas las interfaces de red detectadas en el equipo host. En caso de error, devuelve una lista con cero elementos.
QNetworkInterface::InterfaceFlags QNetworkInterface::flags() const
Devuelve los indicadores asociados a esta interfaz de red.
QString QNetworkInterface::hardwareAddress() const
Devuelve la dirección de hardware de bajo nivel de esta interfaz. En las interfaces Ethernet, se tratará de una dirección MAC en formato de cadena, separada por dos puntos.
Otros tipos de interfaz pueden tener otros tipos de direcciones de hardware. Las implementaciones no deben dar por sentado que esta función devuelva una dirección MAC válida.
Véase también type().
QString QNetworkInterface::humanReadableName() const
Devuelve el nombre legible para el usuario de esta interfaz de red en Windows, como «Conexión de área local», si se ha podido determinar el nombre. Si no ha sido posible, esta función devuelve lo mismo que name(). El nombre legible para el usuario es un nombre que el usuario puede modificar en el Panel de control de Windows, por lo que puede cambiar durante la ejecución del programa.
En Unix, esta función devuelve actualmente siempre el mismo resultado que name(), ya que los sistemas Unix no almacenan una configuración para los nombres legibles para el usuario.
int QNetworkInterface::index() const
Devuelve el índice del sistema de la interfaz, si se conoce. Se trata de un número entero asignado por el sistema operativo para identificar esta interfaz y, por lo general, no cambia. Coincide con el campo «scope ID» de las direcciones IPv6.
Si se desconoce el índice, esta función devuelve 0.
[static] QNetworkInterface QNetworkInterface::interfaceFromIndex(int index)
Devuelve un objeto ` QNetworkInterface ` para la interfaz cuyo ID interno es ` index`. Las interfaces de red tienen un identificador único denominado «índice de interfaz» que permite distinguirlas de otras interfaces del sistema. A menudo, este valor se asigna de forma progresiva, por lo que las interfaces que se eliminan y luego se vuelven a añadir reciben un valor diferente cada vez.
Este índice también se encuentra en el campo «scope ID» de la dirección IPv6.
[static] QNetworkInterface QNetworkInterface::interfaceFromName(const QString &name)
Devuelve un objeto ` QNetworkInterface ` correspondiente a la interfaz denominada ` name`. Si dicha interfaz no existe, esta función devuelve un objeto ` QNetworkInterface ` no válido.
La cadena name puede ser un nombre de interfaz real (como «eth0» o «en1») o un índice de interfaz en forma de cadena («1», «2», etc.).
Véanse también name() y isValid().
[static] int QNetworkInterface::interfaceIndexFromName(const QString &name)
Devuelve el índice de la interfaz cuyo nombre es name o 0 si no existe ninguna interfaz con ese nombre. Esta función debería dar el mismo resultado que el código siguiente, pero probablemente se ejecutará más rápido.
QNetworkInterface::interfaceFromName(name).index()Véase también interfaceFromName(), interfaceNameFromIndex() y QNetworkDatagram::interfaceIndex().
[static] QString QNetworkInterface::interfaceNameFromIndex(int index)
Devuelve el nombre de la interfaz cuyo índice es index o una cadena vacía si no existe ninguna interfaz con ese índice. Esta función debería dar el mismo resultado que el código siguiente, pero probablemente se ejecutará más rápido.
QNetworkInterface::interfaceFromIndex(index).name()Véase también interfaceFromIndex(), interfaceIndexFromName() y QNetworkDatagram::interfaceIndex().
bool QNetworkInterface::isValid() const
Devuelve « true » si este objeto « QNetworkInterface » contiene información válida sobre una interfaz de red.
int QNetworkInterface::maximumTransmissionUnit() const
Devuelve la unidad máxima de transmisión de esta interfaz, si se conoce; en caso contrario, devuelve 0.
La unidad máxima de transmisión es el paquete más grande que se puede enviar por esta interfaz sin que se produzca fragmentación a nivel de enlace. Las aplicaciones pueden utilizar este valor para calcular el tamaño de la carga útil que cabrá en un datagrama UDP sin fragmentar. Recuerda restar los tamaños de las cabeceras utilizadas en tu comunicación a través de la interfaz, por ejemplo, TCP (20 bytes) o UDP (12), IPv4 (20) o IPv6 (40, salvo que se utilice algún tipo de compresión de cabeceras), al calcular el tamaño de la carga útil que puedes transmitir. Ten en cuenta también que la MTU a lo largo de toda la ruta (la MTU de ruta) hasta el destino puede ser menor que la MTU de la interfaz.
Véase también QUdpSocket.
QString QNetworkInterface::name() const
Devuelve el nombre de esta interfaz de red. En sistemas Unix, se trata de una cadena que contiene el tipo de interfaz y, opcionalmente, un número de secuencia, como «eth0», «lo» o «pcn0». En Windows, es un identificador interno que el usuario no puede modificar.
[noexcept] void QNetworkInterface::swap(QNetworkInterface &other)
Intercambia esta instancia de interfaz de red por other. Esta operación es muy rápida y nunca falla.
QNetworkInterface::InterfaceType QNetworkInterface::type() const
Devuelve el tipo de esta interfaz, si es posible determinarlo. Si no es posible determinarlo, esta función devuelve ` QNetworkInterface::Unknown`.
Véase también hardwareAddress().
QNetworkInterface &QNetworkInterface::operator=(const QNetworkInterface &other)
Copia el contenido del objeto « QNetworkInterface » que se encuentra en « other » a este.
Elementos no miembros relacionados
QDebug operator<<(QDebug debug, const QNetworkInterface &networkInterface)
Escribe el objeto ` QNetworkInterface ` networkInterface en el flujo y devuelve una referencia al flujo ` debug `.
© 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.