QMqttMessage Class
Die Klasse „QMqttMessage“ liefert Informationen zu einer Nachricht, die auf der Grundlage eines Abonnements von einem Message Broker empfangen wurde. Mehr...
| Header: | #include <QMqttMessage> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Mqtt) target_link_libraries(mytarget PRIVATE Qt6::Mqtt) |
| qmake: | QT += mqtt |
Eigenschaften
Öffentliche Funktionen
| 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 |
Ausführliche Beschreibung
Im Modul wird eine MQTT-Nachricht erstellt und über das Signal „ QMqttSubscription::messageReceived()“ zurückgegeben.
Dokumentation der Eigenschaften
[read-only] duplicate : const bool
Diese Eigenschaft gibt an, ob es sich bei der Nachricht um ein Duplikat handelt.
Doppelte Nachrichten weisen darauf hin, dass die Nachricht bereits zuvor gesendet wurde, jedoch noch nicht bestätigt wurde. Daher geht der Broker davon aus, dass er die Nachricht erneut senden muss, um den Transport der Nachricht selbst zu überprüfen. Doppelte Nachrichten können nur auftreten, wenn die QoS-Stufe eins oder zwei ist.
Zugriffsfunktionen:
| bool | duplicate() const |
[read-only] id : const quint16
Diese Eigenschaft enthält die ID der Nachricht.
IDs werden für Nachrichten mit einer QoS-Stufe über Null verwendet.
Zugriffsfunktionen:
| quint16 | id() const |
[read-only] payload : const QByteArray
Diese Eigenschaft enthält die Nutzdaten einer Nachricht.
Zugriffsfunktionen:
| const QByteArray & | payload() const |
[read-only] qos : const quint8
Diese Eigenschaft enthält die QoS-Stufe einer Nachricht.
Zugriffsfunktionen:
| quint8 | qos() const |
[read-only] retain : const bool
Diese Eigenschaft gibt an, ob die Nachricht gespeichert wurde.
Eine zurückbehaltene Nachricht wird auf dem Broker gespeichert, damit zukünftige Clients sie abonnieren können. Folglich wurde eine zurückbehaltene Nachricht bereits zuvor erstellt und stellt keine Live-Aktualisierung dar. Ein Broker kann pro Thema nur eine zurückbehaltene Nachricht speichern.
Zugriffsfunktionen:
| bool | retain() const |
[read-only] topic : const QMqttTopicName
Diese Eigenschaft enthält das Thema einer Nachricht.
Falls für ein Abonnement ein Platzhalter verwendet wurde, beschreibt diese Eigenschaft das Thema, das diesem Abonnement entspricht. Diese Eigenschaft enthält niemals Platzhalter.
Zugriffsfunktionen:
| QMqttTopicName | topic() const |
Dokumentation zu den Member-Funktionen
QMqttMessage::QMqttMessage()
Erstellt eine neue MQTT-Nachricht.
QMqttMessage::QMqttMessage(const QMqttMessage &other)
Erstellt eine neue MQTT-Nachricht, die eine Kopie von other ist.
QMqttPublishProperties QMqttMessage::publishProperties() const
Gibt die als Teil der Nachricht empfangenen Veröffentlichungseigenschaften zurück.
Hinweis: Diese Funktion gibt die Eigenschaften nur an, wenn eine „Publish“-Nachricht empfangen wird. Nachrichten mit einem QoS-Wert von 1 oder 2 können beim Freigeben der Nachricht zusätzliche Eigenschaften enthalten. Diese können über das Signal „ QMqttClient::messageStatusChanged “ abgerufen werden.
Hinweis: Diese Funktion liefert nur dann gültige Daten, wenn der Client „ QMqttClient::MQTT_5_0 “ als „ QMqttClient::ProtocolVersion “ angibt.
bool QMqttMessage::operator!=(const QMqttMessage &other) const
Gibt „ true “ zurück, wenn die Nachricht und „ other “ nicht identisch sind, andernfalls „ false “.
QMqttMessage &QMqttMessage::operator=(const QMqttMessage &other)
Erstellt eine Kopie von „ other “ und gibt den neuen Wert dieses Objekts zurück.
bool QMqttMessage::operator==(const QMqttMessage &other) const
Gibt „ true “ zurück, wenn die Nachricht und „ other “ identisch sind, andernfalls „ 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.
