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 der Mitgliedsfunktionen

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

Erzeugt ein QUdpSocket-Objekt.

parent wird an den QObject -Konstruktor übergeben.

Siehe auch socketType().

[virtual noexcept] QUdpSocket::~QUdpSocket()

Zerstört den Socket und schließt die Verbindung, falls erforderlich.

Siehe auch close().

bool QUdpSocket::hasPendingDatagrams() const

Gibt true zurück, wenn mindestens ein Datagramm darauf wartet, gelesen zu werden; andernfalls wird false zurückgegeben.

Siehe auch pendingDatagramSize() und readDatagram().

bool QUdpSocket::joinMulticastGroup(const QHostAddress &groupAddress)

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

Beachten Sie, dass, wenn Sie versuchen, einer IPv4-Gruppe beizutreten, Ihr Socket nicht mit IPv6 (oder im Dualmodus mit QHostAddress::Any) gebunden sein darf. Sie müssen stattdessen QHostAddress::AnyIPv4 verwenden.

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)

Dies ist eine überladene Funktion.

Tritt der Multicast-Gruppenadresse groupAddress an 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 gewählten Standardschnittstelle. 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)

Dies ist eine überladene Funktion.

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

Siehe auch joinMulticastGroup().

QNetworkInterface QUdpSocket::multicastInterface() const

Gibt die Schnittstelle für die ausgehende Schnittstelle für Multicast-Datagramme 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 gesetzt wurde, gibt diese Funktion ein ungültiges QNetworkInterface zurück. Der Socket muss sich im BoundState befinden, andernfalls wird ein ungültiges QNetworkInterface zurückgegeben.

Siehe auch setMulticastInterface().

qint64 QUdpSocket::pendingDatagramSize() const

Gibt die Größe des ersten anstehenden UDP-Datagramms zurück. Wenn kein Datagramm verfügbar ist, 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 Bytes ist, und speichert es in data. Die Host-Adresse und der Port des Absenders werden in *address und *port gespeichert (sofern die Zeiger nicht nullptr sind).

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

Wenn maxSize zu klein ist, geht der Rest des Datagramms verloren. Um Datenverluste zu vermeiden, rufen Sie pendingDatagramSize() auf, um die Größe des anstehenden Datagramms zu ermitteln, bevor Sie versuchen, es zu lesen. Wenn maxSize gleich 0 ist, 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 zusammen mit der Hostadresse und dem Port des Absenders im Objekt QNetworkDatagram zurück. Wenn möglich, versucht diese Funktion auch, die Zieladresse des Datagramms, den Port und die Anzahl der Sprünge zum Zeitpunkt des Empfangs zu bestimmen.

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

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

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

void QUdpSocket::setMulticastInterface(const QNetworkInterface &iface)

Setzt die ausgehende Schnittstelle für Multicast-Datagramme auf die Schnittstelle iface. 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 nichts aus.

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

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

Sendet das Datagramm unter data mit der Größe size an die Host-Adresse address am 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 aber bis zu 8192 Bytes betragen. Wenn das Datagramm zu groß ist, gibt diese Funktion -1 zurück und error() gibt DatagramTooLargeError zurück.

Das Senden von Datagrammen, die größer als 512 Bytes sind, ist im Allgemeinen nicht empfehlenswert, da sie, selbst wenn sie erfolgreich gesendet werden, wahrscheinlich von der IP-Schicht fragmentiert werden, bevor sie an ihrem endgültigen Ziel ankommen.

Siehe auch readDatagram() und write().

qint64 QUdpSocket::writeDatagram(const QNetworkDatagram &datagram)

Dies ist eine überladene Funktion.

Sendet das Datagramm datagram an die Host-Adresse und die Port-Nummern, die in datagram enthalten sind, unter Verwendung der ebenfalls dort eingestellten Grenzen für die Netzwerkschnittstelle und die Anzahl der Sprünge. Wenn die Zieladresse und die Portnummern nicht gesetzt sind, sendet diese Funktion an die Adresse, die an connectToHost() übergeben wurde.

Handelt es sich bei der Zieladresse um eine IPv6-Adresse mit einem nicht leeren scope id, die sich jedoch vom Schnittstellenindex in datagram unterscheidet, ist nicht definiert, über welche Schnittstelle das Betriebssystem senden soll.

Die Funktion gibt die Anzahl der gesendeten Bytes zurück, wenn sie erfolgreich war, oder -1, wenn sie auf einen Fehler gestoßen ist.

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

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

Dies ist eine überladene Funktion.

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

Die Funktion gibt die Anzahl der gesendeten Bytes zurück, wenn sie erfolgreich war, oder -1, wenn sie auf einen Fehler gestoßen ist.