QHostAddress Class

Documentation des fonctions membres

QHostAddress::QHostAddress()

Crée un objet d'adresse hôte nulle, c'est-à-dire une adresse qui n'est valable pour aucun hôte ni aucune interface.

Voir aussi ` clear()`.

QHostAddress::QHostAddress(QHostAddress::SpecialAddress address)

Crée un objet QHostAddress pour address.

[explicit] QHostAddress::QHostAddress(const QString &address)

Crée une adresse IPv4 ou IPv6 à partir de la chaîne « address » (par exemple, « 127.0.0.1 »).

Voir également setAddress().

[explicit] QHostAddress::QHostAddress(const Q_IPV6ADDR &ip6Addr)

Crée un objet d'adresse hôte avec l'adresse IPv6 ip6Addr.

[explicit] QHostAddress::QHostAddress(const quint8 *ip6Addr)

Crée un objet d'adresse hôte avec l'adresse IPv6 ip6Addr.

ip6Addr Doit être un tableau de 16 octets au format « network byte order » (big-endian).

[explicit] QHostAddress::QHostAddress(const sockaddr *sockaddr)

Crée une adresse IPv4 ou IPv6 à partir de l'adresse spécifiée par la structure native sockaddr.

Voir également setAddress().

[explicit] QHostAddress::QHostAddress(quint32 ip4Addr)

Crée un objet d'adresse hôte avec l'adresse IPv4 ip4Addr.

QHostAddress::QHostAddress(const QHostAddress &address)

Crée une copie de l'address.

[constexpr noexcept default, since 6.8] QHostAddress::QHostAddress(QHostAddress &&other)

La fonction « Move » construit un nouvel objet `QHostAddress` à partir de ` other`.

Cette fonction a été introduite dans Qt 6.8.

[noexcept] QHostAddress::~QHostAddress()

Supprime l'objet d'adresse hôte.

void QHostAddress::clear()

Définit l'adresse hôte sur null et le protocole sur QAbstractSocket::UnknownNetworkLayerProtocol.

Voir également QHostAddress::Null.

bool QHostAddress::isBroadcast() const

Renvoie « true » si l'adresse est l'adresse de diffusion IPv4, « false » dans le cas contraire. L'adresse de diffusion IPv4 est 255.255.255.255.

Notez que cette fonction ne renvoie pas « true » pour l'adresse de diffusion locale d'un réseau IPv4. Pour cela, veuillez utiliser QNetworkInterface afin d'obtenir les adresses de diffusion de la machine locale.

Voir également isLoopback(), isGlobal(), isMulticast(), isLinkLocal(), isUniqueLocalUnicast() et isPrivateUse().

bool QHostAddress::isEqual(const QHostAddress &other, QHostAddress::ConversionMode mode = TolerantConversion) const

Renvoie « true » si cette adresse hôte correspond à l'adresse « other » fournie ; sinon, renvoie « false ».

Le paramètre mode contrôle les conversions effectuées entre les adresses de protocoles différents. Si aucune valeur de mode n’est fournie, la conversion TolerantConversion est effectuée par défaut.

Voir également ConversionMode et operator==().

bool QHostAddress::isGlobal() const

Renvoie true si l'adresse est une adresse globale IPv4 ou IPv6, false dans le cas contraire. Une adresse globale est une adresse qui n'est pas réservée à des fins particulières (comme le loopback ou la multidiffusion) ni à des fins futures.

Notez que les adresses unicast locales uniques IPv6 sont considérées comme des adresses globales (voir isUniqueLocalUnicast()), tout comme les adresses IPv4 réservées aux réseaux locaux par la RFC 1918.

Notez également que les adresses IPv6 locales au site sont obsolètes et doivent être considérées comme globales dans les nouvelles applications. Cette fonction renvoie également « true » pour les adresses locales au site.

Voir également isLoopback(), isSiteLocal(), isUniqueLocalUnicast() et isPrivateUse().

bool QHostAddress::isInSubnet(const QHostAddress &subnet, int netmask) const

Renvoie « true » si cette adresse IP appartient au sous-réseau décrit par le préfixe de réseau subnet et le masque de réseau netmask.

Le paramètre netmask correspond à la longueur du préfixe, c'est-à-dire au nombre de bits de tête utilisés pour identifier la partie réseau de l'adresse. Pour IPv4, les valeurs valides vont de 0 à 32 ; pour IPv6, de 0 à 128.

Une adresse IP est considérée comme appartenant à un sous-réseau si elle se situe entre l’adresse la plus basse et l’adresse la plus haute de ce sous-réseau. Dans le cas de la version 4 du protocole IP, l’adresse la plus basse est l’adresse réseau, tandis que l’adresse la plus haute est l’adresse de diffusion.

L’argument ` subnet ` ne doit pas nécessairement correspondre à l’adresse réseau réelle (l’adresse la plus basse du sous-réseau). Il peut s’agir de n’importe quelle adresse IP valide appartenant à ce sous-réseau. En particulier, s’il est égal à l’adresse IP détenue par cet objet, cette fonction renverra toujours `true` (à condition que la longueur du préfixe soit une valeur valide).

Voir également parseSubnet().

bool QHostAddress::isInSubnet(const std::pair<QHostAddress, int> &subnet) const

Renvoie « true » si cette adresse IP se trouve dans le sous-réseau décrit par « subnet ». Le membre « QHostAddress » de « subnet » contient le préfixe du réseau et le membre « int » (second) contient le masque de réseau (longueur du préfixe).

bool QHostAddress::isLinkLocal() const

Renvoie « true » si l'adresse est une adresse locale de liaison IPv4 ou IPv6, et « false » dans le cas contraire.

Une adresse locale de liaison IPv4 est une adresse appartenant au réseau 169.254.0.0/16. Une adresse locale de liaison IPv6 est une adresse appartenant au réseau fe80::/10. Pour plus d’informations, consultez le registre des espaces d’adressage IPv6 de l’IANA.

Voir également isLoopback(), isGlobal(), isMulticast(), isSiteLocal(), isUniqueLocalUnicast() et isPrivateUse().

bool QHostAddress::isLoopback() const

renvoie « true » si l'adresse correspond à l'adresse de bouclage IPv6 ou à l'une des adresses de bouclage IPv4.

bool QHostAddress::isMulticast() const

Renvoie « true » si l'adresse est une adresse de multidiffusion IPv4 ou IPv6, et « false » dans le cas contraire.

Voir également isLoopback(), isGlobal(), isLinkLocal(), isSiteLocal(), isUniqueLocalUnicast() et isPrivateUse().

bool QHostAddress::isNull() const

Renvoie « true » si cette adresse d'hôte n'est valide pour aucun hôte ni aucune interface.

Le constructeur par défaut crée une adresse nulle.

Voir également QHostAddress::Null.

[since 6.6] bool QHostAddress::isPrivateUse() const

Renvoie « true » si l'adresse est une adresse IPv6 locale unique en unicast ou une adresse IPv4 réservée aux réseaux locaux par la RFC 1918; sinon, elle renvoie « false ».

Cette fonction a été introduite dans Qt 6.6.

Voir également isLoopback(), isGlobal(), isMulticast(), isLinkLocal(), isUniqueLocalUnicast() et isBroadcast().

bool QHostAddress::isSiteLocal() const

Renvoie « true » si l'adresse est une adresse IPv6 locale au site, et « false » dans le cas contraire.

Une adresse IPv6 locale au site est une adresse appartenant au réseau fec0::/10. Pour plus d’informations, consultez le registre des espaces d’adressage IPv6 de l’IANA.

Les adresses IPv6 locales au site sont obsolètes et ne doivent pas être utilisées dans les nouvelles applications. Les nouvelles applications ne doivent pas dépendre de cette fonction et doivent considérer les adresses locales au site comme des adresses globales (c’est pourquoi isGlobal() renvoie également « true »). Les adresses locales au site ont été remplacées par les adresses locales uniques (ULA).

Voir également isLoopback(), isGlobal(), isMulticast(), isLinkLocal(), isUniqueLocalUnicast() et isPrivateUse().

bool QHostAddress::isUniqueLocalUnicast() const

Renvoie « true » si l'adresse est une adresse IPv6 locale unique en unicast, et « false » dans le cas contraire.

Une adresse IPv6 locale unique en unicast est une adresse appartenant au réseau fc00::/7. Pour plus d’informations, consultez le registre des espaces d’adressage IPv6 de l’IANA.

Notez que les adresses unicast locales uniques sont également considérées comme des adresses globales. La RFC 4193 précise qu’en pratique, « les applications peuvent traiter ces adresses comme des adresses de portée globale ». Seuls les routeurs doivent tenir compte de cette distinction.

Voir également isLoopback(), isGlobal(), isMulticast(), isLinkLocal() et isPrivateUse().

[static] std::pair<QHostAddress, int> QHostAddress::parseSubnet(const QString &subnet)

Analyse les informations relatives à l'adresse IP et au sous-réseau contenues dans subnet et renvoie le préfixe réseau correspondant ainsi que la longueur de ce préfixe.

L'adresse IP et le masque de réseau doivent être séparés par une barre oblique (/).

Cette fonction prend en charge les arguments sous la forme :

• 123.123.123.123/n, où n est une valeur comprise entre 0 et 32
• 123.123.123.123/255.255.255.255
• <adresse IPv6>/n où n est une valeur comprise entre 0 et 128

Pour la version 4 du protocole IP, cette fonction accepte également les composants finaux manquants (c'est-à-dire moins de 4 octets, comme « 192.168.1 »), suivis ou non d'un point. Si le masque de réseau est également manquant dans ce cas, il est défini sur le nombre d'octets effectivement transmis (dans l'exemple ci-dessus, ce serait 24, pour 3 octets).

Voir également isInSubnet().

int QHostAddress::protocol() const

Renvoie le protocole de la couche réseau associé à l'adresse de l'hôte.

QString QHostAddress::scopeId() const

Renvoie l'identifiant de portée d'une adresse IPv6. Pour les adresses IPv4, ou si l'adresse ne contient pas d'identifiant de portée, une chaîne vide ( QString ) est renvoyée.

L’identifiant de portée IPv6 spécifie la portée d’accessibilité des adresses IPv6 non globales, limitant ainsi la zone dans laquelle l’adresse peut être utilisée. Toutes les adresses IPv6 sont associées à une telle portée d’accessibilité. L’identifiant de portée sert à lever toute ambiguïté concernant les adresses dont l’unicité globale n’est pas garantie.

IPv6 spécifie les quatre niveaux d’accessibilité suivants :

• Local au nœud : adresses utilisées uniquement pour communiquer avec des services sur la même interface (par exemple, l’interface de bouclage « ::1 »).
• Local à la liaison : adresses propres à l’interface réseau (liaison). Il existe toujours une adresse locale à la liaison pour chaque interface IPv6 de votre hôte. Les adresses locales à la liaison (« fe80... ») sont générées à partir de l’adresse MAC de la carte réseau locale et leur unicité n’est pas garantie.
• Globales : pour les adresses routables à l’échelle mondiale, telles que celles des serveurs publics sur Internet.

Lorsque vous utilisez une adresse locale de liaison ou locale de site pour des connexions IPv6, vous devez spécifier l’identifiant de portée. L’identifiant de portée d’une adresse locale de liaison correspond généralement au nom de l’interface (par exemple, « eth0 », « en1 ») ou à son numéro (par exemple, « 1 », « 2 »).

Voir également setScopeId(), QNetworkInterface et QNetworkInterface::interfaceFromName.

void QHostAddress::setAddress(quint32 ip4Addr)

Définissez l'adresse IPv4 indiquée par ip4Addr.

void QHostAddress::setAddress(QHostAddress::SpecialAddress address)

Définit l'adresse spéciale spécifiée par address.

bool QHostAddress::setAddress(const QString &address)

Définit l'adresse IPv4 ou IPv6 spécifiée par la représentation sous forme de chaîne indiquée par ` address ` (par exemple, « 127.0.0.1 »). Renvoie ` true ` et définit l'adresse si celle-ci a été analysée avec succès ; sinon, renvoie ` false`.

void QHostAddress::setAddress(const Q_IPV6ADDR &ip6Addr)

Définit l'adresse IPv6 spécifiée par ip6Addr.

void QHostAddress::setAddress(const quint8 *ip6Addr)

Définissez l'adresse IPv6 spécifiée par ip6Addr.

ip6Addr Il doit s'agir d'un tableau de 16 octets dans l'ordre des octets du réseau (octet de poids fort en premier).

void QHostAddress::setAddress(const sockaddr *sockaddr)

Définit l'adresse IPv4 ou IPv6 spécifiée par la structure native ` sockaddr`. Renvoie ` true ` et définit l'adresse si celle-ci a été analysée avec succès ; sinon, renvoie ` false`.

void QHostAddress::setScopeId(const QString &id)

Définit l'identifiant de portée IPv6 de l'adresse sur « id ». Si le protocole de l'adresse n'est pas IPv6, cette fonction n'a aucun effet. L’ID de portée peut être défini sous la forme d’un nom d’interface (tel que « eth0 » ou « en1 ») ou d’un nombre entier représentant l’index de l’interface. Si id est un nom d’interface, QtNetwork le convertira en un index d’interface à l’aide de QNetworkInterface::interfaceIndexFromName() avant d’appeler les fonctions réseau du système d’exploitation.

Voir également scopeId(), QNetworkInterface et QNetworkInterface::interfaceFromName.

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

Permute cette adresse hôte avec celle de other. Cette opération est très rapide et ne rate jamais.

quint32 QHostAddress::toIPv4Address(bool *ok = nullptr) const

Renvoie l'adresse IPv4 sous forme de nombre.

Par exemple, si l'adresse est 127.0.0.1, la valeur renvoyée est 2130706433 (c'est-à-dire 0x7f000001).

Cette valeur est valide si l'protocol() est IPv4Protocol, ou si le protocole est IPv6Protocol, et si l'adresse IPv6 est une adresse mappée IPv4 (RFC4291). Dans ces cas, ok sera défini sur true. Sinon, il sera défini sur false.

Voir également toString().

Q_IPV6ADDR QHostAddress::toIPv6Address() const

Renvoie l'adresse IPv6 sous la forme d'une structure Q_IPV6ADDR. Cette structure est composée de 16 caractères non signés.

Q_IPV6ADDR addr = hostAddr.toIPv6Address();
// addr contains 16 unsigned characters

for (int i = 0; i < 16; ++i) {
    // process addr[i]
}

Cette valeur est valide si la fonction ` protocol()` renvoie ` IPv6Protocol`. Si le protocole est ` IPv4Protocol`, l'adresse est alors renvoyée sous la forme d'une adresse IPv6 mappée en IPv4. (RFC4291)

Voir également toString().

QString QHostAddress::toString() const

Renvoie l'adresse sous forme de chaîne de caractères.

Par exemple, si l'adresse est l'adresse IPv4 127.0.0.1, la chaîne renvoyée est « 127.0.0.1 ». Pour IPv6, le format de la chaîne de caractères suivra la recommandation RFC5952. Pour QHostAddress::Any, c'est son adresse IPv4 qui sera renvoyée (« 0.0.0.0 »)

Voir aussi toIPv4Address().

bool QHostAddress::operator!=(QHostAddress::SpecialAddress other) const

Renvoie « true » si cette adresse hôte ne correspond pas à l’adresse « other » fournie ; sinon, renvoie « false ».

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

Renvoie « true » si cette adresse d'hôte ne correspond pas à l'adresse « other » fournie ; sinon, renvoie « false ».

QHostAddress &QHostAddress::operator=(QHostAddress::SpecialAddress address)

Attribue l'adresse spéciale address à cet objet et renvoie une référence à celui-ci.

Voir également setAddress().

QHostAddress &QHostAddress::operator=(const QHostAddress &address)

Attribue une autre adresse hôte address à cet objet et renvoie une référence à cet objet.

bool QHostAddress::operator==(QHostAddress::SpecialAddress other) const

Renvoie « true » si cette adresse hôte correspond à l'adresse « other » fournie ; sinon, renvoie « false ».

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

Renvoie « true » si cette adresse hôte est identique à l'adresse « other » fournie ; sinon, renvoie « false ». Cet opérateur appelle simplement « isEqual » (autre, « StrictConversion »).

Voir également isEqual().