====== std.mqtt — netzfreier MQTT-Codec ====== ''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. ===== Units ===== ^ 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. ===== Versionen und Fehler ===== 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.