QMqttMessage Class
La classe QMqttMessage fournit des informations sur un message reçu d'un courtier de messages dans le cadre d'un abonnement. En savoir plus...
| En-tête : | #include <QMqttMessage> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Mqtt) target_link_libraries(mytarget PRIVATE Qt6::Mqtt) |
| qmake : | QT += mqtt |
Propriétés
Fonctions publiques
| QMqttMessage() | |
| QMqttMessage(const QMqttMessage &other) | |
| bool | duplicate() const |
| quint16 | id() const |
| const QByteArray & | payload() const |
| QMqttPublishProperties | publishProperties() const |
| quint8 | qos() const |
| bool | retain() const |
| QMqttTopicName | topic() const |
| bool | operator!=(const QMqttMessage &other) const |
| QMqttMessage & | operator=(const QMqttMessage &other) |
| bool | operator==(const QMqttMessage &other) const |
Description détaillée
Un message MQTT est créé au sein du module et renvoyé via le signal ` QMqttSubscription::messageReceived()`.
Documentation des propriétés
[read-only] duplicate : const bool
Cette propriété indique si le message est un doublon.
Les messages en double indiquent que le message a déjà été envoyé, mais qu’il n’a pas encore été confirmé. Le courtier part donc du principe qu’il doit le renvoyer afin de vérifier la transmission du message lui-même. Les messages en double ne peuvent se produire que si le niveau de qualité de service (QoS) est égal à un ou deux.
Fonctions d'accès :
| bool | duplicate() const |
[read-only] id : const quint16
Cette propriété contient l'identifiant du message.
Les identifiants sont utilisés pour les messages dont le niveau de qualité de service (QoS) est supérieur à zéro.
Fonctions d'accès :
| quint16 | id() const |
[read-only] payload : const QByteArray
Cette propriété contient le contenu d'un message.
Fonctions d'accès :
| const QByteArray & | payload() const |
[read-only] qos : const quint8
Cette propriété contient le niveau de qualité de service (QoS) d'un message.
Fonctions d'accès :
| quint8 | qos() const |
[read-only] retain : const bool
Cette propriété indique si le message a été conservé.
Un message conservé est stocké sur le broker afin que de futurs clients puissent s'y abonner. Par conséquent, un message conservé a été créé précédemment et ne constitue pas une mise à jour en temps réel. Un broker ne peut stocker qu'un seul message conservé par sujet.
Fonctions d'accès :
| bool | retain() const |
[read-only] topic : const QMqttTopicName
Cette propriété contient le sujet d'un message.
Si un caractère générique a été utilisé pour un abonnement, elle décrit le sujet correspondant à cet abonnement. Cette propriété ne contient jamais de caractères génériques.
Fonctions d'accès :
| QMqttTopicName | topic() const |
Documentation des fonctions membres
QMqttMessage::QMqttMessage()
Crée un nouveau message MQTT.
QMqttMessage::QMqttMessage(const QMqttMessage &other)
Crée un nouveau message MQTT qui est une copie de other.
QMqttPublishProperties QMqttMessage::publishProperties() const
Renvoie les propriétés de publication reçues dans le cadre du message.
Remarque : cette fonction ne spécifie les propriétés que lorsqu'un message de publication est reçu. Les messages dont la valeur QoS est égale à 1 ou 2 peuvent contenir des propriétés supplémentaires lors de leur diffusion. Celles-ci peuvent être obtenues via le signal QMqttClient::messageStatusChanged.
Remarque : cette fonction ne fournit des données valides que lorsque le client spécifie QMqttClient::MQTT_5_0 sous la forme QMqttClient::ProtocolVersion.
bool QMqttMessage::operator!=(const QMqttMessage &other) const
Renvoie « true » si le message et « other » ne sont pas identiques ; sinon, renvoie « false ».
QMqttMessage &QMqttMessage::operator=(const QMqttMessage &other)
Fait de cet objet une copie de other et renvoie la nouvelle valeur de cet objet.
bool QMqttMessage::operator==(const QMqttMessage &other) const
Renvoie « true » si le message et « other » sont identiques ; sinon, renvoie « false ».
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
