std.mqtt ist kein MQTT-Client und öffnet keine Verbindung. Die vier Units bilden und prüfen MQTT-3.1.1- und MQTT-5.0-Pakete im Speicher. Damit kann ein eigener Transport (TCP, TLS, Datei oder Testpuffer) darübergelegt werden.
| Unit | Aufgabe |
|---|---|
std.mqtt.wire | Fixed Header, Pakettypen, Remaining Length, UTF-8-Felder und Byte-Framing |
std.mqtt.topic | Strenges UTF-8 sowie Topic Names, Filter, +/# und Shared Subscriptions prüfen |
std.mqtt.props | MQTT-5-Properties typisieren, paketbezogen zulassen und auslesen |
std.mqtt.packet | CONNECT, CONNACK, PUBLISH, SUBSCRIBE, ACKs, DISCONNECT und Paket-Ergebnisblöcke |
Die Paket-API kopiert Nutzdaten nicht. Ergebnisblöcke enthalten Offsets und Längen in den Eingangspuffer; dessen Lebensdauer muss deshalb bis zur Auswertung erhalten bleiben.
Die Protokollversion wird explizit geführt: MQ_V311 steht für Protocol Level 4, MQ_V5 für Level 5. Eine MQTT-5-Property in einem 3.1.1-Paket ist ein Fehler. Fehlercodes unterscheiden unvollständige Puffer, ungültige Fixed-Header-Flags, falsche Remaining Length, ungültige UTF-8-Daten, Topic-Fehler und unzulässige Properties.
import std.mqtt.wire;
import std.mqtt.topic;
import std.mqtt.packet;
var rc: int64 := MqTopicFilterPruefe(topic, topicLen, true);
if (rc != MQ_OK) {
// Filter verwerfen; rc bezeichnet den konkreten Protokollfehler.
}
Für die netzgebundene Variante bleibt std.net.mqtt zuständig. Sie ist eine andere Schicht mit Socket-Abhängigkeiten; std.mqtt bleibt vollständig netzfrei und eignet sich daher auch für Broker-Adapter, Tests und eingebettete Transporte.
Letzte Aktualisierung: 2026-11-09 — MQTT 3.1.1/5.0-Codec aus aurum/std/mqtt ergänzt.