CKTIS / C++
Ein-/Ausgabe und explizite binäre Serialisierung
Ein- und Ausgabe übertragen Daten, während die Serialisierung ihre Darstellung festlegt. Lerne, eine Ganzzahl in Little-Endian-Reihenfolge zu codieren, sicher zu decodieren und die Round-Trip-Prüfung durch den Vergleich mit bekannten Bytes zu ergänzen.
Version: C++23; repository compiler flag, production runtime not attested
Syntax
serialization: value -> specified bytes; deserialization: validated bytes -> value; round-trip validation: deserialize(serialize(value)) == valueEin- und Ausgabe (I/O) übertragen Daten zwischen einem Programm und seiner Umgebung. Serialisierung wandelt Werte in eine vereinbarte Darstellung um; Deserialisierung rekonstruiert sie nach einer Prüfung der Eingabe. C++-Streams unterstützen das Lesen und Schreiben; die Übertragung von Bytes allein definiert kein Datenformat.
Ein Format sollte Feldbreiten, Byte-Reihenfolge und Validierungsregeln festlegen. Little-Endian-Reihenfolge legt das niederwertigste Byte zuerst ab: 0x1234 wird als 0x34, 0x12 codiert. Das Beispiel codiert eine vorzeichenlose 16-Bit-Ganzzahl in genau zwei 8-Bit-Bytes. Verschiebungen und Maskierung machen das Format unabhängig von der Byte-Reihenfolge der Maschine; vorausgesetzt werden CHAR_BIT == 8 und die Verfügbarkeit des optionalen Typs std::uint16_t.
Das Ausgeben des rohen Speichers eines Objekts ist kein portables Format: Seine Darstellung kann Füllbits enthalten und von der Implementierung abhängen; außerdem speichern Zeiger nicht die Daten, auf die sie zeigen. Die Erlaubnis, Bytes trivial kopierbarer Typen zu kopieren, garantiert keine kompatiblen Dateien auf verschiedenen Plattformen. Auch der Binärmodus einer Datei standardisiert die Objektdarstellung nicht.
Die Round-Trip-Prüfung kontrolliert deserialize(serialize(value)) == value. Das Beispiel vergleicht die Bytes zusätzlich mit einem bekannten Ergebnis, da zwei fehlerhafte Algorithmen ihre Fehler gegenseitig aufheben können. Der Decoder weist Längen ungleich zwei zurück, bevor er auf die Daten zugreift; hier ist jede Folge aus zwei Bytes ein gültiger Wert. Bei größeren Formaten sind außerdem Bereichs-, Längen- und Versionsprüfungen sowie die Behandlung von I/O-Fehlern erforderlich.
Der Code ist für die Kompilierung mit einem C++23-Flag vorgesehen. Der angezeigte Quellcode wurde unverändert in einer isolierten Umgebung ausgeführt; die Ausgabe stimmte exakt mit dem angegebenen Ergebnis überein. Dieser Lauf belegt nicht, dass der Code in einer Produktionsumgebung funktioniert. Die Quelle eel.is ist ein fortlaufend bearbeiteter Arbeitsentwurf, keine eingefrorene C++23-Veröffentlichung.
Beispiele
#include <array>
#include <climits>
#include <cstdint>
#include <iostream>
#include <optional>
#include <span>
static_assert(CHAR_BIT == 8);
std::array<unsigned char, 2> serialize(std::uint16_t value) {
return {static_cast<unsigned char>(value & 0xffu),
static_cast<unsigned char>(value >> 8)};
}
std::optional<std::uint16_t> deserialize(
std::span<const unsigned char> bytes) {
if (bytes.size() != 2) return std::nullopt;
return static_cast<std::uint16_t>(
static_cast<unsigned int>(bytes[0]) |
(static_cast<unsigned int>(bytes[1]) << 8));
}
int main() {
const std::uint16_t original = 0x1234;
const auto bytes = serialize(original);
const auto restored = deserialize(bytes);
const bool round_trip = restored && *restored == original;
const bool known_bytes = bytes[0] == 0x34 && bytes[1] == 0x12;
const bool rejected = !deserialize(
std::span<const unsigned char>{bytes.data(), 1});
std::cout << "bytes: " << static_cast<unsigned int>(bytes[0])
<< ' ' << static_cast<unsigned int>(bytes[1]) << '\n'
<< std::boolalpha
<< "round-trip: " << round_trip << '\n'
<< "known bytes: " << known_bytes << '\n'
<< "invalid length rejected: " << rejected << '\n';
return round_trip && known_bytes && rejected ? 0 : 1;
}
Ergebnis
bytes: 52 18 round-trip: true known bytes: true invalid length rejected: true
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.