QNetworkInterface Class

Documentation sur les fonctions-membres

QNetworkInterface::QNetworkInterface()

Crée un objet d'interface réseau vide.

QNetworkInterface::QNetworkInterface(const QNetworkInterface &other)

Crée une copie de l'objet `QNetworkInterface` contenu dans ` other`.

[noexcept] QNetworkInterface::~QNetworkInterface()

Libère les ressources associées à l'objet ` QNetworkInterface `.

QList<QNetworkAddressEntry> QNetworkInterface::addressEntries() const

Renvoie la liste des adresses IP attribuées à cette interface, ainsi que les masques de réseau et les adresses de diffusion associés.

Si le masque de réseau, l'adresse de diffusion ou d'autres informations ne sont pas nécessaires, vous pouvez appeler la fonction ` allAddresses()` pour obtenir uniquement les adresses IP des interfaces actives.

[static] QList<QHostAddress> QNetworkInterface::allAddresses()

Cette fonction pratique renvoie toutes les adresses IP détectées sur la machine hôte. Elle revient à appeler ` addressEntries()` sur tous les objets renvoyés par ` allInterfaces()` qui se trouvent dans l'état « QNetworkInterface::IsUp » afin d'obtenir des listes d'objets ` QNetworkAddressEntry `, puis à appeler ` QNetworkAddressEntry::ip()` sur chacun d'entre eux.

[static] QList<QNetworkInterface> QNetworkInterface::allInterfaces()

Renvoie la liste de toutes les interfaces réseau détectées sur la machine hôte. En cas d'échec, elle renvoie une liste vide.

QNetworkInterface::InterfaceFlags QNetworkInterface::flags() const

Renvoie les indicateurs associés à cette interface réseau.

QString QNetworkInterface::hardwareAddress() const

Renvoie l'adresse matérielle de bas niveau de cette interface. Sur les interfaces Ethernet, il s'agit d'une adresse MAC sous forme de chaîne de caractères, séparée par des deux-points.

D'autres types d'interfaces peuvent utiliser d'autres types d'adresses matérielles. Les implémentations ne doivent pas supposer que cette fonction renvoie une adresse MAC valide.

Voir également type().

QString QNetworkInterface::humanReadableName() const

Renvoie le nom lisible par l'utilisateur de cette interface réseau sous Windows, tel que « Connexion au réseau local », si ce nom a pu être déterminé. Si ce n'est pas le cas, cette fonction renvoie la même valeur que la fonction ` name()`. Le nom lisible par l'utilisateur est un nom que l'utilisateur peut modifier dans le Panneau de configuration de Windows ; il peut donc changer pendant l'exécution du programme.

Sous Unix, cette fonction renvoie actuellement toujours la même valeur que name(), car les systèmes Unix ne stockent pas de configuration pour les noms lisibles par l'utilisateur.

int QNetworkInterface::index() const

Renvoie l'index système de l'interface, s'il est connu. Il s'agit d'un entier attribué par le système d'exploitation pour identifier cette interface ; il ne change généralement pas. Il correspond au champ « scope ID » des adresses IPv6.

Si l'index n'est pas connu, cette fonction renvoie 0.

[static] QNetworkInterface QNetworkInterface::interfaceFromIndex(int index)

Renvoie un objet ` QNetworkInterface ` correspondant à l'interface dont l'identifiant interne est ` index`. Les interfaces réseau possèdent un identifiant unique appelé « index d'interface », qui permet de les distinguer des autres interfaces du système. Souvent, cette valeur est attribuée de manière progressive ; ainsi, les interfaces qui sont supprimées puis rajoutées se voient attribuer une valeur différente à chaque fois.

Cet index figure également dans le champ « scope ID » de l'adresse IPv6.

[static] QNetworkInterface QNetworkInterface::interfaceFromName(const QString &name)

Renvoie un objet ` QNetworkInterface ` correspondant à l'interface nommée ` name`. Si cette interface n'existe pas, cette fonction renvoie un objet ` QNetworkInterface ` non valide.

La chaîne name peut être soit un nom d’interface réel (tel que « eth0 » ou « en1 »), soit un index d’interface sous forme de chaîne (« 1 », « 2 », etc.).

Voir également name() et isValid().

[static] int QNetworkInterface::interfaceIndexFromName(const QString &name)

Renvoie l'index de l'interface dont le nom est « name » ou 0 s'il n'existe aucune interface portant ce nom. Cette fonction devrait produire le même résultat que le code suivant, mais s'exécutera probablement plus rapidement.

    QNetworkInterface::interfaceFromName(name).index()

Voir également interfaceFromName(), interfaceNameFromIndex() et QNetworkDatagram::interfaceIndex().

[static] QString QNetworkInterface::interfaceNameFromIndex(int index)

Renvoie le nom de l'interface dont l'index est index ou une chaîne vide s'il n'existe aucune interface portant cet index. Cette fonction devrait produire le même résultat que le code suivant, mais s'exécutera probablement plus rapidement.

    QNetworkInterface::interfaceFromIndex(index).name()

Voir également interfaceFromIndex(), interfaceIndexFromName() et QNetworkDatagram::interfaceIndex().

bool QNetworkInterface::isValid() const

Renvoie « true » si cet objet « QNetworkInterface » contient des informations valides concernant une interface réseau.

int QNetworkInterface::maximumTransmissionUnit() const

Renvoie l'unité de transmission maximale sur cette interface, si elle est connue, ou 0 dans le cas contraire.

L'unité de transmission maximale correspond au plus grand paquet pouvant être envoyé sur cette interface sans entraîner de fragmentation au niveau de la liaison. Les applications peuvent utiliser cette valeur pour calculer la taille de la charge utile pouvant tenir dans un datagramme UDP non fragmenté. N’oubliez pas de soustraire les tailles des en-têtes utilisés dans vos communications sur cette interface, par exemple TCP (20 octets) ou UDP (12), IPv4 (20) ou IPv6 (40, en l’absence de compression des en-têtes), lorsque vous calculez la taille de la charge utile que vous pouvez transmettre. Notez également que la MTU sur l'ensemble du chemin (la MTU de chemin) vers la destination peut être inférieure à la MTU de l'interface.

Voir également QUdpSocket.

QString QNetworkInterface::name() const

Renvoie le nom de cette interface réseau. Sur les systèmes Unix, il s'agit d'une chaîne de caractères contenant le type de l'interface et, éventuellement, un numéro d'ordre, tel que « eth0 », « lo » ou « pcn0 ». Sous Windows, il s'agit d'un identifiant interne qui ne peut pas être modifié par l'utilisateur.

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

Permute cette instance d'interface réseau avec celle de other. Cette opération est très rapide et ne rencontre jamais d'échec.

QNetworkInterface::InterfaceType QNetworkInterface::type() const

Renvoie le type de cette interface, s'il a pu être déterminé. S'il n'a pas pu être déterminé, cette fonction renvoie « QNetworkInterface::Unknown ».

Voir également hardwareAddress().

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

Copie le contenu de l'objet « QNetworkInterface » contenu dans « other » dans celui-ci.