QHostAddress Class

Dokumentation der Mitgliedsfunktionen

QHostAddress::QHostAddress()

Konstruiert ein Null-Host-Adressobjekt, d. h. eine Adresse, die für keinen Host oder keine Schnittstelle gültig ist.

Siehe auch clear().

QHostAddress::QHostAddress(QHostAddress::SpecialAddress address)

Konstruiert ein QHostAddress-Objekt für address.

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

Konstruiert eine IPv4- oder IPv6-Adresse basierend auf der Zeichenkette address (z. B. "127.0.0.1").

Siehe auch setAddress().

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

Konstruiert ein Host-Adressobjekt mit der IPv6-Adresse ip6Addr.

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

Konstruiert ein Host-Adressobjekt mit der IPv6-Adresse ip6Addr.

ip6Addr muss ein 16-Byte-Array in Netzwerk-Byte-Reihenfolge (Big Endian) sein.

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

Konstruiert eine IPv4- oder IPv6-Adresse unter Verwendung der in der nativen Struktur sockaddr angegebenen Adresse.

Siehe auch setAddress().

[explicit] QHostAddress::QHostAddress(quint32 ip4Addr)

Konstruiert ein Host-Adressobjekt mit der IPv4-Adresse ip4Addr.

QHostAddress::QHostAddress(const QHostAddress &address)

Konstruiert eine Kopie der angegebenen address.

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

Move-konstruiert eine neue QHostAddress aus other.

Diese Funktion wurde in Qt 6.8 eingeführt.

[noexcept] QHostAddress::~QHostAddress()

Zerstört das Host-Adressobjekt.

void QHostAddress::clear()

Setzt die Hostadresse auf null und das Protokoll auf QAbstractSocket::UnknownNetworkLayerProtocol.

Siehe auch QHostAddress::Null.

bool QHostAddress::isBroadcast() const

Gibt true zurück, wenn die Adresse die IPv4-Broadcast-Adresse ist, andernfalls false. Die IPv4-Broadcast-Adresse lautet 255.255.255.255.

Beachten Sie, dass diese Funktion nicht true für die lokale Broadcast-Adresse eines IPv4-Netzwerks zurückgibt. Verwenden Sie dazu bitte QNetworkInterface, um die Broadcast-Adressen des lokalen Rechners zu erhalten.

Siehe auch isLoopback(), isGlobal(), isMulticast(), isLinkLocal(), isUniqueLocalUnicast(), und isPrivateUse().

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

Gibt true zurück, wenn diese Host-Adresse mit der angegebenen other -Adresse übereinstimmt; andernfalls wird false zurückgegeben.

Der Parameter mode steuert, welche Konvertierungen zwischen Adressen unterschiedlicher Protokolle durchgeführt werden. Wenn kein mode angegeben wird, wird standardmäßig TolerantConversion ausgeführt.

Siehe auch ConversionMode und operator==().

bool QHostAddress::isGlobal() const

Gibt true zurück, wenn die Adresse eine globale IPv4- oder IPv6-Adresse ist, andernfalls false. Eine globale Adresse ist eine Adresse, die nicht für spezielle Zwecke (wie Loopback oder Multicast) oder zukünftige Zwecke reserviert ist.

Beachten Sie, dass IPv6 eindeutige lokale Unicast-Adressen als globale Adressen gelten (siehe isUniqueLocalUnicast()), ebenso wie IPv4-Adressen, die nach RFC 1918 für lokale Netzwerke reserviert sind.

Beachten Sie auch, dass IPv6-site-local-Adressen veraltet sind und in neuen Anwendungen als global betrachtet werden sollten. Diese Funktion gibt auch für standortlokale Adressen true zurück.

Siehe auch isLoopback(), isSiteLocal(), isUniqueLocalUnicast(), und isPrivateUse().

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

Gibt true zurück, wenn diese IP in dem Subnetz liegt, das durch das Netzwerkpräfix subnet und die Netzmaske netmask beschrieben wird.

Eine IP wird als zu einem Subnetz gehörig betrachtet, wenn sie zwischen der niedrigsten und der höchsten Adresse in diesem Subnetz enthalten ist. Im Fall von IP Version 4 ist die niedrigste Adresse die Netzwerkadresse, während die höchste Adresse die Broadcast-Adresse ist.

Das Argument subnet muss nicht die tatsächliche Netzwerkadresse sein (die niedrigste Adresse im Subnetz). Es kann jede gültige IP sein, die zu diesem Subnetz gehört. Wenn es gleich der IP-Adresse dieses Objekts ist, gibt diese Funktion immer true zurück (vorausgesetzt, die Netzmaske ist ein gültiger Wert).

Siehe auch parseSubnet().

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

Dies ist eine überladene Funktion.

Gibt true zurück, wenn diese IP in dem durch subnet beschriebenen Subnetz liegt. Der Member QHostAddress von subnet enthält das Netzwerkpräfix und der int (zweite) Member enthält die Netzmaske (Präfixlänge).

bool QHostAddress::isLinkLocal() const

Gibt true zurück, wenn die Adresse eine IPv4- oder IPv6-link-lokale Adresse ist, andernfalls false.

Eine IPv4 link-local Adresse ist eine Adresse im Netzwerk 169.254.0.0/16. Eine IPv6 link-local Adresse ist eine Adresse im Netzwerk fe80::/10. Weitere Informationen finden Sie in der IANA IPv6 Address Space Registry.

Siehe auch isLoopback(), isGlobal(), isMulticast(), isSiteLocal(), isUniqueLocalUnicast(), und isPrivateUse().

bool QHostAddress::isLoopback() const

gibt true zurück, wenn die Adresse die IPv6-Loopback-Adresse ist, oder eine der IPv4-Loopback-Adressen.

bool QHostAddress::isMulticast() const

Gibt true zurück, wenn die Adresse eine IPv4- oder IPv6-Multicast-Adresse ist, andernfalls false.

Siehe auch isLoopback(), isGlobal(), isLinkLocal(), isSiteLocal(), isUniqueLocalUnicast(), und isPrivateUse().

bool QHostAddress::isNull() const

Gibt true zurück, wenn diese Hostadresse für keinen Host oder keine Schnittstelle gültig ist.

Der Standardkonstruktor erzeugt eine Nulladresse.

Siehe auch QHostAddress::Null.

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

Gibt true zurück, wenn die Adresse eine eindeutige lokale IPv6-Unicast-Adresse oder eine nach RFC 1918 für lokale Netzwerke reservierte IPv4-Adresse ist, andernfalls false.

Diese Funktion wurde in Qt 6.6 eingeführt.

Siehe auch isLoopback(), isGlobal(), isMulticast(), isLinkLocal(), isUniqueLocalUnicast(), und isBroadcast().

bool QHostAddress::isSiteLocal() const

Gibt true zurück, wenn die Adresse eine IPv6-Site-Local-Adresse ist, andernfalls false.

Eine IPv6-Site-Local-Adresse ist eine Adresse im Netzwerk fec0::/10. Weitere Informationen finden Sie in der IANA IPv6 Address Space registry.

IPv6-site-local-Adressen sind veraltet und sollten in neuen Anwendungen nicht mehr verwendet werden. Neue Anwendungen sollten sich nicht auf diese Funktion verlassen und standortlokale Adressen genauso behandeln wie globale (weshalb isGlobal() auch true zurückgibt). Standortlokale Adressen wurden durch Unique Local Addresses (ULA) ersetzt.

Siehe auch isLoopback(), isGlobal(), isMulticast(), isLinkLocal(), isUniqueLocalUnicast(), und isPrivateUse().

bool QHostAddress::isUniqueLocalUnicast() const

Gibt true zurück, wenn die Adresse eine eindeutige lokale IPv6-Unicast-Adresse ist, andernfalls false.

Eine eindeutige lokale IPv6-Unicast-Adresse ist eine Adresse im Netzwerk fc00::/7. Weitere Informationen finden Sie in der IANA IPv6 Address Space registry.

Beachten Sie, dass eindeutige lokale Unicast-Adressen auch als globale Adressen zählen. RFC 4193 besagt, dass in der Praxis "Anwendungen diese Adressen wie globale Adressen behandeln können". Nur Router müssen sich um diese Unterscheidung kümmern.

Siehe auch isLoopback(), isGlobal(), isMulticast(), isLinkLocal(), isUniqueLocalUnicast(), und isPrivateUse().

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

Analysiert die in subnet enthaltenen IP- und Subnetzinformationen und gibt das Netzwerkpräfix für dieses Netzwerk und seine Präfixlänge zurück.

Die IP-Adresse und die Netzmaske müssen durch einen Schrägstrich (/) getrennt werden.

Diese Funktion unterstützt Argumente in der Form:

• 123.123.123.123/n, wobei n ein beliebiger Wert zwischen 0 und 32 ist
• 123.123.123.123/255.255.255.255
• <ipv6-address>/n, wobei n ein beliebiger Wert zwischen 0 und 128 ist

Für IP Version 4 akzeptiert diese Funktion auch fehlende Endkomponenten (d.h. weniger als 4 Oktette, wie "192.168.1"), gefolgt oder nicht von einem Punkt. Fehlt auch in diesem Fall die Netzmaske, wird sie auf die Anzahl der tatsächlich übergebenen Oktette gesetzt (im obigen Beispiel wäre sie 24, also 3 Oktette).

Siehe auch isInSubnet().

int QHostAddress::protocol() const

Gibt das Netzwerkschichtprotokoll der Hostadresse zurück.

QString QHostAddress::scopeId() const

Gibt die Scope-ID einer IPv6-Adresse zurück. Bei IPv4-Adressen oder wenn die Adresse keine Scope-ID enthält, wird eine leere QString zurückgegeben.

Die IPv6-Scope-ID gibt den Erreichbarkeitsbereich für nicht-globale IPv6-Adressen an und schränkt den Bereich ein, in dem die Adresse verwendet werden kann. Alle IPv6-Adressen sind mit einem solchen Erreichbarkeitsbereich verbunden. Die Scope-ID wird zur Disambiguierung von Adressen verwendet, die nicht garantiert global eindeutig sind.

IPv6 spezifiziert die folgenden vier Ebenen der Erreichbarkeit:

• Node-local: Adressen, die nur für die Kommunikation mit Diensten auf derselben Schnittstelle verwendet werden (z. B. die Loopback-Schnittstelle "::1").
• Link-local: Adressen, die für die Netzwerkschnittstelle(Link) lokal sind. Es gibt immer eine link-local-Adresse für jede IPv6-Schnittstelle auf Ihrem Host. Link-lokale Adressen ("fe80...") werden aus der MAC-Adresse des lokalen Netzwerkadapters generiert und sind nicht garantiert eindeutig.
• Global: Für global routbare Adressen, wie z. B. öffentliche Server im Internet.

Wenn Sie eine link-local oder site-local Adresse für IPv6-Verbindungen verwenden, müssen Sie die Scope-ID angeben. Die Scope-ID für eine link-lokale Adresse ist in der Regel identisch mit dem Schnittstellennamen (z. B. "eth0", "en1") oder der Nummer (z. B. "1", "2").

Siehe auch setScopeId(), QNetworkInterface, und QNetworkInterface::interfaceFromName.

void QHostAddress::setAddress(quint32 ip4Addr)

Stellen Sie die durch ip4Addr angegebene IPv4-Adresse ein.

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

Dies ist eine überladene Funktion.

Setzt die durch address angegebene Spezialadresse.

bool QHostAddress::setAddress(const QString &address)

Dies ist eine überladene Funktion.

Setzt die IPv4- oder IPv6-Adresse, die durch die von address angegebene Zeichenkettendarstellung angegeben wird (z. B. "127.0.0.1"). Gibt true zurück und setzt die Adresse, wenn die Adresse erfolgreich geparst wurde; andernfalls gibt sie false zurück.

void QHostAddress::setAddress(const Q_IPV6ADDR &ip6Addr)

Dies ist eine überladene Funktion.

Setzt die durch ip6Addr angegebene IPv6-Adresse.

void QHostAddress::setAddress(const quint8 *ip6Addr)

Dies ist eine überladene Funktion.

Setzt die durch ip6Addr angegebene IPv6-Adresse.

ip6Addr muss ein Array von 16 Bytes in Netzwerk-Byte-Reihenfolge sein (höherwertiges Byte zuerst).

void QHostAddress::setAddress(const sockaddr *sockaddr)

Dies ist eine überladene Funktion.

Setzt die IPv4- oder IPv6-Adresse, die durch die native Struktur sockaddr angegeben ist. Gibt true zurück und setzt die Adresse, wenn die Adresse erfolgreich geparst wurde; andernfalls gibt sie false zurück.

void QHostAddress::setScopeId(const QString &id)

Setzt die IPv6-Bereichskennung der Adresse auf id. Wenn das Adressprotokoll nicht IPv6 ist, bewirkt diese Funktion nichts. Die Scope-ID kann als Schnittstellenname (z. B. "eth0" oder "en1") oder als Ganzzahl, die den Schnittstellenindex darstellt, festgelegt werden. Wenn id ein Schnittstellenname ist, wird QtNetwork mit QNetworkInterface::interfaceIndexFromName() in einen Schnittstellenindex umgewandelt, bevor die Netzwerkfunktionen des Betriebssystems aufgerufen werden.

Siehe auch scopeId(), QNetworkInterface, und QNetworkInterface::interfaceFromName.

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

Tauscht diese Host-Adresse mit other aus. Dieser Vorgang ist sehr schnell und schlägt nie fehl.

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

Gibt die IPv4-Adresse als Zahl zurück.

Ist die Adresse beispielsweise 127.0.0.1, lautet der zurückgegebene Wert 2130706433 (d. h. 0x7f000001).

Dieser Wert ist gültig, wenn protocol() IPv4Protocol ist, oder wenn das Protokoll IPv6Protocol ist und die IPv6-Adresse eine IPv4-gemappte Adresse ist (RFC4291). In diesen Fällen wird ok auf true gesetzt. Andernfalls wird der Wert auf false gesetzt.

Siehe auch toString().

Q_IPV6ADDR QHostAddress::toIPv6Address() const

Gibt die IPv6-Adresse als Q_IPV6ADDR-Struktur zurück. Die Struktur besteht aus 16 vorzeichenlosen Zeichen.

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

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

Dieser Wert ist gültig, wenn das Protokoll protocol() IPv6Protocol ist. Ist das Protokoll IPv4Protocol, wird die Adresse als IPv4-gemappte IPv6-Adresse zurückgegeben. (RFC4291)

Siehe auch toString().

QString QHostAddress::toString() const

Gibt die Adresse als Zeichenkette zurück.

Wenn die Adresse beispielsweise die IPv4-Adresse 127.0.0.1 ist, lautet die zurückgegebene Zeichenfolge "127.0.0.1". Bei IPv6 folgt das String-Format der Empfehlung von RFC5952. Für QHostAddress::Any wird die IPv4-Adresse zurückgegeben ("0.0.0.0").

Siehe auch toIPv4Address().

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

Gibt true zurück, wenn diese Host-Adresse nicht mit der angegebenen other -Adresse übereinstimmt; andernfalls wird false zurückgegeben.

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

Gibt true zurück, wenn diese Host-Adresse nicht mit der angegebenen other -Adresse übereinstimmt; andernfalls wird false zurückgegeben.

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

Weist diesem Objekt die spezielle Adresse address zu und gibt einen Verweis auf dieses Objekt zurück.

Siehe auch setAddress().

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

Weist diesem Objekt einen anderen Host address zu und gibt einen Verweis auf dieses Objekt zurück.

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

Gibt true zurück, wenn diese Hostadresse mit der angegebenen Adresse other übereinstimmt; andernfalls wird false zurückgegeben.

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

Gibt true zurück, wenn diese Host-Adresse mit der angegebenen other -Adresse übereinstimmt; andernfalls wird false zurückgegeben. Dieser Operator ruft einfach isEqual(andere, StrictConversion) auf.

Siehe auch isEqual().