QMqttMessage Class
Die Klasse QMqttMessage liefert Informationen über eine Nachricht, die von einem Message Broker auf der Grundlage eines Abonnements empfangen wurde. Mehr...
| Kopfzeile: | #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 |
Detaillierte Beschreibung
Eine MQTT-Nachricht wird innerhalb des Moduls erstellt und über das Signal QMqttSubscription::messageReceived() zurückgegeben.
Dokumentation der Eigenschaften
[read-only] duplicate : const bool
Diese Eigenschaft gibt an, ob die Nachricht ein Duplikat ist.
Doppelte Nachrichten zeigen an, dass die Nachricht bereits gesendet wurde, aber noch nicht bestätigt wurde. Daher geht der Broker davon aus, dass er erneut senden muss, um den Transport der Nachricht selbst zu verifizieren. 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 Nutzlast 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 aufbewahrt wurde.
Eine aufbewahrte Nachricht wird im Makler aufbewahrt, damit zukünftige Kunden sie abonnieren können. Folglich wurde eine aufbewahrte Nachricht zuvor erstellt und ist keine Live-Aktualisierung. Ein Broker kann nur eine gespeicherte Nachricht pro Thema speichern.
Zugriffsfunktionen:
| bool | retain() const |
[read-only] topic : const QMqttTopicName
Diese Eigenschaft enthält das Thema einer Nachricht.
Falls ein Platzhalter für ein Abonnement verwendet wurde, beschreibt sie das Thema, das diesem Abonnement entspricht. Diese Eigenschaft enthält niemals Wildcards.
Zugriffsfunktionen:
| QMqttTopicName | topic() const |
Dokumentation der Mitgliedsfunktionen
QMqttMessage::QMqttMessage()
Erzeugt eine neue MQTT-Nachricht.
QMqttMessage::QMqttMessage(const QMqttMessage &other)
Konstruiert 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 nur die Eigenschaften an, wenn eine Publish Message empfangen wird. Nachrichten mit einem QoS-Wert von 1 oder 2 können zusätzliche Eigenschaften enthalten, wenn eine Nachricht freigegeben wird. Diese können über das Signal QMqttClient::messageStatusChanged abgefragt 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 gleich sind, ansonsten false.
QMqttMessage &QMqttMessage::operator=(const QMqttMessage &other)
Macht dieses Objekt zu einer 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 gleich sind, andernfalls wird false zurückgegeben.
© 2025 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.
