QUdpSocket 类

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);
    }
}

成员函数文档

[显式] QUdpSocket::QUdpSocket(QObject *parent = nullptr)

创建一个QUdpSocket对象。

parent传递给QObject构造函数。

另请参阅 socketType。

[虚拟非要害操作] QUdpSocket::~QUdpSocket()

销毁套接字，如果需要则关闭连接。

另请参阅 close。

bool QUdpSocket::hasPendingDatagrams() const

如果有数据包等待读取，则返回true；否则返回false。

另请参阅 pendingDatagramSize()和readDatagram。

bool QUdpSocket::joinMulticastGroup(const QHostAddress &groupAddress)

在操作系统选择的默认接口上将指定的多播组groupAddress加入多播组。套接字必须在BoundState中，否则将发生错误。

请注意，如果您正在尝试加入IPv4组，则您的套接字不得使用IPv6绑定（或在双模式中使用 QHostAddress::Any）。您必须使用 QHostAddress::AnyIPv4。

此函数在成功时返回 true；否则返回 false 并设置套接字错误。

另请参阅：leaveMulticastGroup()。

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

这是一个重载函数。

在接口 iface 上连接多播组地址 groupAddress。

另请参阅：leaveMulticastGroup()。

bool QUdpSocket::leaveMulticastGroup(const QHostAddress &groupAddress)

离开由 groupAddress 指定的多播组，操作系统选择的默认接口。套接字必须在bound状态，否则将发生错误。

此函数在成功时返回 true；否则返回 false 并设置套接字错误。

另请参阅：joinMulticastGroup()。

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

这是一个重载函数。

离开接口 iface 上由 groupAddress 指定的多播组。

另请参阅：joinMulticastGroup()。

QNetworkInterface QUdpSocket::multicastInterface() const

返回多播数据报出的接口。这对应于IPv4套接字的IP_MULTICAST_IF套接字选项和IPv6套接字的IPV6_MULTICAST_IF套接字选项。如果没有之前设置接口，则此函数返回一个无效的 QNetworkInterface。套接字必须在bound状态，否则返回无效的 QNetworkInterface。

另请参阅：setMulticastInterface()。

qint64 QUdpSocket::pendingDatagramSize() const

返回第一个待处理UDP数据报的大小。如果没有可用的数据报，此函数返回-1。

另请参阅：hasPendingDatagrams() 和 readDatagram()。

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

接收一个不超过 maxSize 字节的报文，并将其存储在 data 中。发送者的主机地址和端口号存储在 *address 和 *port 中（除非指针是 nullptr）。

在成功时返回数据报的长度；否则返回-1。

如果 maxSize 过小，则数据报的其他部分将丢失。为了避免数据丢失，在尝试读取数据报之前，请调用 pendingDatagramSize() 以确定待处理数据报的大小。如果 maxSize 为 0，则将丢弃数据报。

另请参阅 writeDatagram()，hasPendingDatagrams() 和 pendingDatagramSize。

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

接收一个不超过 maxSize 字节的数据报，并在 QNetworkDatagram 对象中返回它，以及发送者的主机地址和端口。如果可能，此函数还将在接收时尝试确定数据报的目的地址、端口和跃计数。

失败时，返回一个报告 无效 的 QNetworkDatagram。

如果 maxSize 过小，则数据报的其他部分将丢失。如果 maxSize 为 0，则将丢弃数据报。如果 maxSize 为 -1（默认值），则此函数将尝试读取整个数据报。

另请参阅 writeDatagram()，hasPendingDatagrams() 和 pendingDatagramSize。

void QUdpSocket::setMulticastInterface(const QNetworkInterface &iface)

将多播数据报的输出接口设置为 iface。这对应于 IPv4 的 IP_MULTICAST_IF 套接字选项和 IPv6 的 IPV6_MULTICAST_IF 套接字选项。套接字必须是 BoundState，否则此函数不起作用。

另请参阅 multicastInterface()，joinMulticastGroup() 和 leaveMulticastGroup。

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

将大小为 size 的数据报发送到主机地址 address 的端口 port。成功返回发送的字节数；否则返回 -1。

数据报总是以一个块的形式写入。数据报的最大大小高度依赖于平台，但可能低至 8192 字节。如果数据报太大，此函数将返回 -1，并且 error() 将返回 DatagramTooLargeError。

通常不建议发送超过 512 字节的数据报，因为即使在成功发送后，它们在到达最终目的地之前可能也会被 IP 层分段。

另请参阅 readDatagram() 和 write。

qint64 QUdpSocket::writeDatagram(const QNetworkDatagram &datagram)

这是一个重载函数。

将数据报文 datagram 发送到包含在 datagram 中的主机地址和端口号，使用那里也设置的网络接口和跳数限制。如果目标地址和端口号未设置，此函数将发送到 connectToHost() 传递的地址。

如果目标地址是具有非空 作用域 ID 的 IPv6 地址，但与 datagram 中的接口指数不同，则不确定操作系统将选择哪个接口进行发送。

如果成功，该函数返回发送的字节数；如果遇到错误，返回 -1。

另请参阅 QNetworkDatagram::setDestination()，QNetworkDatagram::setHopLimit() 和 QNetworkDatagram::setInterfaceIndex()。

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

这是一个重载函数。

将数据报文 datagram 发送到主机地址 host 和端口号 port。

如果成功，该函数返回发送的字节数；如果遇到错误，返回 -1。