QNetworkInterface Class

Documentation sur les fonctions des membres

QNetworkInterface::QNetworkInterface()

Construit 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 que possède cette interface, ainsi que les masques de réseau et les adresses de diffusion qui leur sont 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 de commodité renvoie toutes les adresses IP trouvées sur la machine hôte. Elle équivaut à appeler addressEntries() sur tous les objets retournés par allInterfaces() qui sont dans l'état QNetworkInterface::IsUp pour obtenir des listes d'objets QNetworkAddressEntry, puis à appeler QNetworkAddressEntry::ip() sur chacun d'entre eux.

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

Renvoie une liste de toutes les interfaces réseau trouvées sur la machine hôte. En cas d'échec, il renvoie une liste contenant zéro élément.

QNetworkInterface::InterfaceFlags QNetworkInterface::flags() const

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

QString QNetworkInterface::hardwareAddress() const

Renvoie l'adresse matérielle de bas niveau de cette interface. Pour 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.

Les autres types d'interface peuvent avoir d'autres types d'adresses matérielles. Les implémentations ne doivent pas dépendre du fait que cette fonction renvoie une adresse MAC valide.

Voir aussi type().

QString QNetworkInterface::humanReadableName() const

Renvoie le nom lisible par l'homme de cette interface réseau sous Windows, tel que "Local Area Connection", si le nom a pu être déterminé. Dans le cas contraire, cette fonction renvoie la même chose que name(). Le nom lisible par l'homme 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 toujours la même chose que name(), car les systèmes Unix ne stockent pas de configuration pour les noms lisibles par l'homme.

int QNetworkInterface::index() const

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

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

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

Renvoie un objet QNetworkInterface pour l'interface dont l'ID interne est index. Les interfaces réseau ont un identifiant unique appelé "index d'interface" qui permet de les distinguer des autres interfaces du système. Souvent, cette valeur est attribuée progressivement et les interfaces qui sont supprimées puis ajoutées à nouveau reçoivent une valeur différente à chaque fois.

Cet index se trouve également dans le champ scope ID de l'adresse IPv6.

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

Renvoie un objet QNetworkInterface pour 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 aussi 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'y a pas d'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 aussi 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'y a pas d'interface avec 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 aussi interfaceFromIndex(), interfaceIndexFromName() et QNetworkDatagram::interfaceIndex().

bool QNetworkInterface::isValid() const

Renvoie true si cet objet QNetworkInterface contient des informations valables sur une interface réseau.

int QNetworkInterface::maximumTransmissionUnit() const

Renvoie l'unité de transmission maximale sur cette interface, si elle est connue, ou 0 sinon.

L'unité de transmission maximale est le plus gros paquet qui peut être envoyé sur cette interface sans subir de fragmentation au niveau du lien. Les applications peuvent utiliser cette valeur pour calculer la taille de la charge utile d'un datagramme UDP non fragmenté. N'oubliez pas de soustraire la taille des en-têtes utilisés dans votre communication sur l'interface, par exemple TCP (20 octets) ou UDP (12), IPv4 (20) ou IPv6 (40, en l'absence d'une forme de compression des en-têtes), lorsque vous calculez la taille de la charge utile que vous pouvez transmettre. Notez également que le MTU le long du chemin complet (le Path MTU) jusqu'à la destination peut être plus petit que le 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 contenant le type de l'interface et éventuellement un numéro de séquence, tel que "eth0", "lo" ou "pcn0". Sous Windows, il s'agit d'un identifiant interne qui ne peut être modifié par l'utilisateur.

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

Remplace cette instance d'interface réseau par other. Cette opération est très rapide et n'échoue jamais.

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.