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.