继承自 QAbstractSocket 类
QUdpSocket类提供UDP套接字。
UDP(用户数据报协议)是一种轻量级、不可靠、面向数据报、无连接的协议。它可以在可靠性不重要的情况下使用。QUdpSocket是QAbstractSocket的一个子类,它允许您发送和接收UDP数据报。
使用这个类最常见的方法是使用bind()绑定到一个地址和端口,然后调用writeDatagram()和readDatagram() / receiveDatagram()来传输数据。如果你想使用标准的QIODevice函数read(), readLine(), write()等,你必须首先通过调用connectToHost()将套接字直接连接到对等体。
套接字每次将数据报写入网络时都会发出bytesWritten()信号。如果您只想发送数据报,则不需要调用bind()。
每当数据报到达时,就会发出readyRead()信号。在这种情况下,hasPendingDatagrams()返回true。调用pendingDatagramSize()来获取第一个挂起数据报的大小,并调用readDatagram()或receiveDatagram()来读取它。
注意:当您接收readyRead()信号时,应该读取传入的数据报,否则将不会为下一个数据报发出该信号。
QUdpSocket还支持UDP组播。使用joinMulticastGroup()和leaveMulticastGroup()来控制组成员,使用QAbstractSocket::MulticastTtlOption和QAbstractSocket::MulticastLoopbackOption来设置TTL和loopback套接字选项。使用setMulticastInterface()控制组播数据报的出接口,使用multicastInterface()进行查询。
使用QUdpSocket,您还可以使用connectToHost()与UDP服务器建立虚拟连接,然后使用read()和write()交换数据报,而无需指定每个数据报的接收者。
The Broadcast Sender, Broadcast Receiver, Multicast Sender, and Multicast Receiver examples illustrate how to use QUdpSocket in applications.
如果至少有一个数据报等待读取,则返回true;否则返回false。
返回第一个挂起的UDP数据报的尺寸,如果没有可用的数据报,则会返回-1。
接收不大于maxSize字节的数据报,并将其存储在data中。发送方的主机地址和端口存储在*address和*port中(除非指针为0)。
成功时返回数据报的大小;否则返回-1。
如果maxSize太小,则数据报的其余部分将丢失。为了避免数据丢失,在尝试读取挂起的数据报之前,调用pendingDatagramSize()来确定它的大小。如果maxSize为0,则丢弃该数据报。
接收不大于maxSize字节的数据报,并在QNetworkDatagram对象中返回它,以及发送方的主机地址和端口。如果可能的话,该函数还将尝试确定数据报的目的地址、端口和接收时的跳数。
如果失败,则返回一个报告无效的QNetworkDatagram。
如果maxSize太小,则数据报的其余部分将丢失。如果maxSize为0,则丢弃该数据报。如果maxSize为-1(默认值),该函数将尝试读取整个数据报。
发送大小为size的数据报到端口为port的主机地址地址。返回成功时发送的字节数;否则返回-1。
数据报总是作为一个块写入。数据报的最大大小高度依赖于平台,但可以低至8192字节。如果数据报太大,此函数将返回-1,error()将返回DatagramTooLargeError。
通常不建议发送大于512字节的数据报,因为即使它们被成功发送,它们也可能在到达最终目的地之前被IP层分片。
警告:在已连接的UDP套接字上调用此函数可能导致错误且不发送数据包。如果您正在使用已连接的套接字,请使用write()来发送数据报。
这是一个重载函数。
将数据报发送到数据报中包含的主机地址和端口号,使用网络接口和跳数限制也设置在那里。如果未设置目的地址和端口号,则该函数将发送到传递给connectToHost()的地址。如果目的地址为IPv6,且作用域id非空,但与数据报中的接口索引不同,则不确定操作系统将选择哪个接口发送。
如果成功,该函数返回发送的字节数,如果遇到错误,则返回-1。
警告:在已连接的UDP套接字上调用此函数可能导致错误且不发送数据包。如果您正在使用已连接的套接字,请使用write()来发送数据报。
这是一个重载函数。
发送数据报数据报到主机地址host和端口port。
如果成功,该函数返回发送的字节数,如果遇到错误,则返回-1。