QNetworkDatagram 类

成员函数文档

创建一个新的代表对该入站数据报的回复的 QNetworkDatagram 并将有效负载数据设置为 payload。此函数是响应数据报回原始发送者的非常方便的方式。

示例

    void Server::readPendingDatagrams()
    {
        while (udpSocket->hasPendingDatagrams()) {
            QNetworkDatagram datagram = udpSocket->receiveDatagram();
            QByteArray replyData = processThePayload(datagram.data());
            udpSocket->writeDatagram(datagram.makeReply(replyData));
        }
    }

此函数特别方便，因为它会自动将相关参数从该数据报复制到新数据报中

• 此数据报的发送者地址和端口将复制到新数据报的目标地址和端口；
• 如果有的话，此数据报的接口索引将复制到新数据报的接口索引；
• 如果地址是IPv6全局（非多播）地址，则将此数据报的源地址和端口复制到新数据报的发送者地址和端口；
• 新数据报的跳数限制重置为默认值（-1）；

如果Qt的未来版本修改 QNetworkDatagram 以携带更多元数据，则此函数将根据需要复制该元数据。

如果目的地地址是IPv4地址，则不会复制，因为这不可能在没有任何方法的情况下区分IPv4广播地址和常规IPv4地址。尝试以发送者的地址等于广播地址的方式发送数据报很可能会失败。然而，这不应影响通信，因为具有多个IPv4地址的网络接口不常见，因此操作系统将选定的地址可能是一个对等方可以理解的地址。

    udpSocket->writeDatagram(std::move(datagram).makeReply(replyData));

QNetworkDatagram::QNetworkDatagram()

创建一个没有任何有效负载数据和无定义目标地址的 QNetworkDatagram 对象。

可以使用 setData() 修改有效负载，可以使用 setDestination() 设置目标地址。

如果目标地址没有被定义，QUdpSocket::writeDatagram() 将尝试通过使用 QUdpSocket::connectToHost() 将数据报到上次关联的地址发送。

QNetworkDatagram::QNetworkDatagram(const QByteArray &data, const QHostAddress &destinationAddress = QHostAddress(), quint16 port = 0)

创建一个QNetworkDatagram对象，并将data设为有效的负载数据，同时destinationAddress和port设为数据报的目标地址。

QNetworkDatagram::QNetworkDatagram(const QNetworkDatagram &other)

创建其他数据报的副本，包括有效负载和元数据。

要创建适合在回复中发送的数据报，请使用QNetworkDatagram::makeReply();

void QNetworkDatagram::clear()

清除此QNetworkDatagram对象中的有效负载数据和元数据，并将它们重置为默认值。

QByteArray QNetworkDatagram::data() const

返回此数据报的数据负载。对于从网络接收到的数据报，它包含数据报的有效负载。对于发出的数据报，它是要发送的数据报。

请注意，数据报可以进行无数据传输，因此返回的QByteArray可能为空。

另请参阅setData。

QHostAddress QNetworkDatagram::destinationAddress() const

返回与该数据报关联的目标地址。对于从网络接收到的数据报，这是对等节点发送数据报的地址，可以是本机本地地址或组播或广播地址。对于出站数据报，它是数据报应发送到的地址。

如果在此数据报上未设置目标地址，则返回的对象会向QHostAddress::isNull()报告为true。

另请参阅senderAddress(), destinationPort()和setDestination。

int QNetworkDatagram::destinationPort() const

返回与该数据报关联的目标端口号。对于从网络接收到的数据报，它是对等节点发送数据报的本地端口号。对于出站数据报，它是数据报应发送到的对等端口号。

如果没有与此数据报关联目标地址，此函数返回-1。

另请参阅destinationAddress(), senderPort()和setDestination。

int QNetworkDatagram::hopLimit() const

返回与此数据报关联的跳数限制。跳数限制是在IP数据包过期并向数据报的发送方发送错误之前，允许转发IP数据包的节点数。在IPv4中，此值通常被称为“生存时间”（TTL）。

如果此数据报是从网络接收的，这是接收后该数据报的剩余跳数，并且每个转发该数据包的节点都会减少1。值为-1表示无法获取跳数限制值。

如果这是出站数据报，这是在发送时要在IP首部设置的值。值为-1表示操作系统应该选择该值。

另请参阅setHopLimit。

uint QNetworkDatagram::interfaceIndex() const

返回与该数据报关联的接口索引。接口索引是一个正数，用于唯一标识操作系统中的网络接口。该数字与QNetworkInterface::index()返回的值匹配。

如果此数据报从网络接收，这是接收数据的接口索引。如果这是一个出站数据报，这是应该发送数据报的接口索引。

值0表示接口索引未知。

另请参阅setInterfaceIndex。

bool QNetworkDatagram::isNull() const

如果此QNetworkDatagram对象为null，则返回true。此函数是isValid的相反。

bool QNetworkDatagram::isValid() const

如果此QNetworkDatagram对象有效，则返回true。一个有效的QNetworkDatagram对象至少包含一个发送者或接收者地址。有效的数据报可以包含空的有效负载。

QHostAddress QNetworkDatagram::senderAddress() const

返回与该数据报关联的发送者地址。对于从网络接收的数据报，它是发送数据报的对等节点地址。对于出站数据报，它是发送时应使用的本地地址。

如果没有在数据报上设置发送者地址，返回的对象将向QHostAddress::isNull返回true。

另请参阅destinationAddress，senderPort和setSender。

int QNetworkDatagram::senderPort() const

返回与该数据报关联的发送者的端口号。对于从网络接收的数据报，这是发送数据报的对等节点的端口号。对于出站数据报，这是应该从该端发送的本地端口号。

如果没有与该数据报关联发送者地址，此函数将返回-1。

另请参阅senderAddress，destinationPort和setSender。

void QNetworkDatagram::setData(const QByteArray &data)

将此数据报的数据有效负载设置为data。通常不需要在接收数据报时调用此函数。对于出站数据报，此函数设置要发送到网络上的数据。

由于数据报可以是空的，因此空的QByteArray是有效值。

另请参阅data。

void QNetworkDatagram::setDestination(const QHostAddress &address, quint16 port)

将与此数据报关联的目标地址设置为地址address和端口号port。目标地址和端口号通常由QUdpSocket在接收时设置，因此不需要在接收数据报上调用此函数。

对于外出数据报，此函数可以用来设置数据报应该发送到的地址。这可以是用来与对等方通信的单播地址，也可以是广播地址或组播地址，用于发送到一组设备。

参阅 QUdpSocket::writeDatagram()，destinationAddress()，destinationPort() 和 setSender()。

void QNetworkDatagram::setHopLimit(int count)

将与此数据报相关联的跳数限制设置为我们equivcount。跳数限制是在IP数据包过期并返回错误到数据报发送者之前允许转发节点的数量。在IPv4中，此值通常称为“存活时间” (TTL)。

通常没有必要在从网络上接收到数据报上调用此函数。

如果是外出包，则发送IP报头时应设置此值。值的合法范围是1到255。该函数还接受-1作为值，指示操作系统选择此值。

参阅 hopLimit()。

void QNetworkDatagram::setInterfaceIndex(uint index)

将与此数据报相关联的接口索引设置为我们equivindex。接口索引是操作系统中唯一标识网络接口的正数。此数字与QNetworkInterface::index()返回的接口值相匹配。

通常没有必要在从网络上接收到数据报上调用此函数。

如果这是外出包，这是数据报应发送的接口索引。值为0指示操作系统应根据其他因素选择接口。

请注意，也可以使用QHostAddress::setScopeId()来设置IPv6目标地址的接口索引，然后使用setDestination()。如果目标地址中设置的σκερ egy和equivalent是equivalent，则操作系统发送数据报的接口是不确定的。

参阅 interfaceIndex() 和 setInterfaceIndex()。

void QNetworkDatagram::setSender(const QHostAddress &address, quint16 port = 0)

将与此数据报相关联的发送方地址设置为地址 address 和端口号 port。发送方地址和端口号通常由接收时QUdpSocket设置，因此不需要在接收到的数据报上调用此函数。

对于外出数据报，此函数可以用来设置数据报应携带的地址。地址 address 通常必须是不给此机器分配的本地地址之一，可以使用QNetworkInterface获取。如果未设置，则操作系统将根据相关的目标选择最合适的地址来使用。

端口号 port 必须是如果有的话与套接字相关联的端口号。可以使用值为0表示操作系统应选择端口号。

另请参阅 QUdpSocket::writeDatagram()，senderAddress()，senderPort()，以及setDestination()。

[noexcept] void QNetworkDatagram::swap(QNetworkDatagram &other)

交换此实例与 other。

QNetworkDatagram &QNetworkDatagram::operator=(const QNetworkDatagram &other)

复制 other 数据报，包括有效载荷和元数据。

要创建适合在回复中发送的数据报，请使用QNetworkDatagram::makeReply();