QUdpSocket Class

void Server::initSocket()
{
    udpSocket = new QUdpSocket(this);
    udpSocket->bind(QHostAddress::LocalHost, 7755);

    connect(udpSocket, &QUdpSocket::readyRead,
            this, &Server::readPendingDatagrams);
}

void Server::readPendingDatagrams()
{
    while (udpSocket->hasPendingDatagrams()) {
        QNetworkDatagram datagram = udpSocket->receiveDatagram();
        processTheDatagram(datagram);
    }
}

Dokumentation zu den Mitgliedsfunktionen

[explicit] QUdpSocket::QUdpSocket(QObject *parent = nullptr)

Erstellt ein QUdpSocket-Objekt.

parent wird an den Konstruktor von ` QObject ` übergeben.

Siehe auch socketType().

[virtual noexcept] QUdpSocket::~QUdpSocket()

Löscht den Socket und schließt gegebenenfalls die Verbindung.

Siehe auch „ close()“.

bool QUdpSocket::hasPendingDatagrams() const

Gibt „ true “ zurück, wenn mindestens ein Datagramm zum Lesen ansteht; andernfalls wird „ false “ zurückgegeben.

Siehe auch pendingDatagramSize() und readDatagram().

bool QUdpSocket::joinMulticastGroup(const QHostAddress &groupAddress)

Tritt der durch „ groupAddress “ angegebenen Multicast-Gruppe auf der vom Betriebssystem ausgewählten Standardschnittstelle bei. Der Socket muss sich im „BoundState“ befinden, andernfalls tritt ein Fehler auf.

Beachten Sie: Wenn Sie versuchen, einer IPv4-Gruppe beizutreten, darf Ihr Socket nicht über IPv6 (oder im Dual-Modus über ` QHostAddress::Any`) gebunden sein. Verwenden Sie stattdessen ` QHostAddress::AnyIPv4 `.

Diese Funktion gibt bei Erfolg „ true “ zurück; andernfalls gibt sie „ false “ zurück und setzt den Socket-Fehler entsprechend.

Siehe auch ` leaveMulticastGroup()`.

bool QUdpSocket::joinMulticastGroup(const QHostAddress &groupAddress, const QNetworkInterface &iface)

Tritt der Multicast-Gruppenadresse groupAddress auf der Schnittstelle iface bei.

Siehe auch leaveMulticastGroup().

bool QUdpSocket::leaveMulticastGroup(const QHostAddress &groupAddress)

Verlässt die durch groupAddress angegebene Multicast-Gruppe auf der vom Betriebssystem ausgewählten Standard-Schnittstelle. Der Socket muss sich im BoundState befinden, andernfalls tritt ein Fehler auf.

Diese Funktion gibt bei Erfolg „ true “ zurück; andernfalls gibt sie „ false “ zurück und setzt den Socket-Fehler entsprechend.

Siehe auch ` joinMulticastGroup()`.

bool QUdpSocket::leaveMulticastGroup(const QHostAddress &groupAddress, const QNetworkInterface &iface)

Verlässt die durch „ groupAddress “ angegebene Multicast-Gruppe auf der Schnittstelle „ iface “.

Siehe auch joinMulticastGroup().

QNetworkInterface QUdpSocket::multicastInterface() const

Gibt die Schnittstelle für den ausgehenden Datenverkehr von Multicast-Datagrammen zurück. Dies entspricht der Socket-Option `IP_MULTICAST_IF` für IPv4-Sockets und der Socket-Option `IPV6_MULTICAST_IF` für IPv6-Sockets. Wenn zuvor keine Schnittstelle festgelegt wurde, gibt diese Funktion einen ungültigen ` QNetworkInterface` zurück. Der Socket muss sich im `BoundState` befinden, andernfalls wird ein ungültiger ` QNetworkInterface ` zurückgegeben.

Siehe auch setMulticastInterface().

qint64 QUdpSocket::pendingDatagramSize() const

Gibt die Größe des ersten ausstehenden UDP-Datagramms zurück. Ist kein Datagramm vorhanden, gibt diese Funktion -1 zurück.

Siehe auch hasPendingDatagrams() und readDatagram().

qint64 QUdpSocket::readDatagram(char *data, qint64 maxSize, QHostAddress *address = nullptr, quint16 *port = nullptr)

Empfängt ein Datagramm, das nicht größer als maxSize Byte ist, und speichert es in data. Die Host-Adresse und der Port des Absenders werden in *address und *port gespeichert (es sei denn, die Zeiger sind nullptr).

Gibt bei Erfolg die Größe des Datagramms zurück; andernfalls wird -1 zurückgegeben.

Ist maxSize zu klein, geht der Rest des Datagramms verloren. Um Datenverlust zu vermeiden, rufen Sie pendingDatagramSize() auf, um die Größe des anstehenden Datagramms zu ermitteln, bevor Sie versuchen, es zu lesen. Ist maxSize gleich 0, wird das Datagramm verworfen.

Siehe auch writeDatagram(), hasPendingDatagrams() und pendingDatagramSize().

QNetworkDatagram QUdpSocket::receiveDatagram(qint64 maxSize = -1)

Empfängt ein Datagramm, das nicht größer als maxSize Bytes ist, und gibt es im Objekt „ QNetworkDatagram “ zusammen mit der Host-Adresse und dem Port des Absenders zurück. Wenn möglich, versucht diese Funktion außerdem, die Zieladresse und den Zielport des Datagramms sowie die Anzahl der Hops zum Zeitpunkt des Empfangs zu ermitteln.

Bei einem Fehler wird ein ` QNetworkDatagram ` zurückgegeben, das ` not valid` meldet.

Ist ` maxSize ` zu klein, geht der Rest des Datagramms verloren. Ist ` maxSize ` gleich 0, wird das Datagramm verworfen. Ist ` maxSize ` gleich -1 (Standardwert), versucht diese Funktion, das gesamte Datagramm zu lesen.

Siehe auch writeDatagram(), hasPendingDatagrams() und pendingDatagramSize().

void QUdpSocket::setMulticastInterface(const QNetworkInterface &iface)

Legt die Ausgangsschnittstelle für Multicast-Datagramme auf die Schnittstelle iface fest. Dies entspricht der Socket-Option IP_MULTICAST_IF für IPv4-Sockets und der Socket-Option IPV6_MULTICAST_IF für IPv6-Sockets. Der Socket muss sich im BoundState befinden, andernfalls führt diese Funktion keine Aktion aus.

Siehe auch multicastInterface(), joinMulticastGroup() und leaveMulticastGroup().

qint64 QUdpSocket::writeDatagram(const char *data, qint64 size, const QHostAddress &address, quint16 port)

Sendet das Datagramm unter der Adresse data mit einer Größe von size an die Host-Adresse address auf Port port. Gibt bei Erfolg die Anzahl der gesendeten Bytes zurück; andernfalls wird -1 zurückgegeben.

Datagramme werden immer als ein Block geschrieben. Die maximale Größe eines Datagramms ist stark plattformabhängig, kann jedoch bis zu 8192 Byte betragen. Ist das Datagramm zu groß, gibt diese Funktion -1 zurück, und error() gibt DatagramTooLargeError zurück.

Vom Senden von Datagrammen, die größer als 512 Bytes sind, wird generell abgeraten, da diese selbst bei erfolgreicher Übertragung wahrscheinlich von der IP-Schicht fragmentiert werden, bevor sie ihr endgültiges Ziel erreichen.

Siehe auch ` readDatagram()` und ` write()`.

qint64 QUdpSocket::writeDatagram(const QNetworkDatagram &datagram)

Sendet das Datagramm datagram an die in datagram enthaltenen Host-Adressen und Portnummern unter Verwendung der dort ebenfalls festgelegten Grenzwerte für die Netzwerkschnittstelle und die Hop-Anzahl. Sind die Zieladresse und die Portnummern nicht festgelegt, sendet diese Funktion an die Adresse, die an connectToHost() übergeben wurde.

Ist die Zieladresse eine IPv6-Adresse mit einem nicht leeren ` scope id `, weicht jedoch vom Schnittstellenindex in ` datagram` ab, ist es undefiniert, welche Schnittstelle das Betriebssystem für den Versand wählt.

Die Funktion gibt die Anzahl der gesendeten Bytes zurück, wenn der Vorgang erfolgreich war, oder -1, wenn ein Fehler aufgetreten ist.

Siehe auch ` QNetworkDatagram::setDestination()`, ` QNetworkDatagram::setHopLimit()` und ` QNetworkDatagram::setInterfaceIndex()`.

qint64 QUdpSocket::writeDatagram(const QByteArray &datagram, const QHostAddress &host, quint16 port)

Sendet das Datagramm datagram an die Host-Adresse host und den Port port.

Die Funktion gibt die Anzahl der gesendeten Bytes zurück, wenn der Vorgang erfolgreich war, oder -1, wenn ein Fehler aufgetreten ist.