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

成员函数文档

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

创建一个 QUdpSocket 对象。

parent 该参数将传递给QObject 构造函数。

另请参阅 socketType()。

[virtual noexcept] 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 指定的、位于操作系统选择的默认接口上的组播组。套接字必须处于BoundState状态，否则会发生错误。

若操作成功，该函数返回true ；否则返回false ，并相应地设置套接字错误。

另请参阅 joinMulticastGroup()。

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

退出由groupAddress 指定的、位于iface 接口上的组播组。

另请参见 joinMulticastGroup()。

QNetworkInterface QUdpSocket::multicastInterface() const

返回用于发送多播数据报的接口。 这对应于 IPv4 套接字的 IP_MULTICAST_IF 套接字选项以及 IPv6 套接字的 IPV6_MULTICAST_IF 套接字选项。如果之前未设置任何接口，则该函数将返回一个无效的 `QNetworkInterface`。套接字必须处于 `BoundState` 状态，否则将返回一个无效的 `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 ，该对象报告not valid 。

如果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 、目标地址为data 的数据报发送到主机地址address 的端口port 。成功时返回已发送的字节数；否则返回 -1。

数据报总是作为一个整体写入的。数据报的最大大小在很大程度上取决于平台，但可能低至 8192 字节。如果数据报过大，此函数将返回 -1，而error() 将返回 DatagramTooLargeError。

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

另请参阅 readDatagram() 和write()。

qint64 QUdpSocket::writeDatagram(const QNetworkDatagram &datagram)

将数据报datagram 发送至datagram 中包含的主机地址和端口号，并使用该文件中设置的网络接口和跳数限制。如果未设置目标地址和端口号，则该函数将向传递给connectToHost() 的地址发送数据。

如果目标地址为 IPv6 且scope id 不为空，但与datagram 中指定的接口索引不一致，则操作系统将选择哪个接口进行发送是未定义的。

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

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

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

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

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