QMqttMessage Class
La classe QMqttMessage fournit des informations sur un message reçu d'un courtier de messages sur la base d'un abonnement. Plus d'informations...
| 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éé dans le module et renvoyé via le signal QMqttSubscription::messageReceived().
Documentation sur les propriétés
[read-only] duplicate : const bool
Cette propriété indique si le message est un double.
Les messages dupliqués indiquent que le message a été envoyé précédemment, mais qu'il n'a pas encore été confirmé. Par conséquent, le courtier suppose qu'il doit renvoyer le message pour en vérifier le transport. Les messages en double ne peuvent se produire que si le niveau de qualité de service est un ou deux.
Fonctions d'accès :
| bool | duplicate() const |
[read-only] id : const quint16
Cette propriété contient l'identifiant du message.
Les ID sont utilisés pour les messages dont le niveau de qualité de service est supérieur à zéro.
Fonctions d'accès :
| quint16 | id() const |
[read-only] payload : const QByteArray
Cette propriété contient la charge utile d'un message.
Fonctions d'accès :
| const QByteArray & | payload() const |
[read-only] qos : const quint8
Cette propriété indique le niveau de qualité de service 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 gardé dans le courtier pour que les futurs clients puissent s'y abonner. Par conséquent, un message conservé a été créé précédemment et n'est pas une mise à jour en temps réel. Un courtier 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)
Construit 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.
Note : Cette fonction spécifie uniquement les propriétés lorsqu'un message de publication est reçu. Les messages ayant une valeur QoS de 1 ou 2 peuvent contenir des propriétés supplémentaires lorsqu'un message est publié. Ces propriétés peuvent être obtenues par le signal QMqttClient::messageStatusChanged.
Note : Cette fonction ne fournira des données valides que si le client spécifie QMqttClient::MQTT_5_0 comme QMqttClient::ProtocolVersion.
bool QMqttMessage::operator!=(const QMqttMessage &other) const
Renvoie true si le message et other ne sont pas égaux, 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 égaux, 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.
