CKTIS / C++
Vstup/výstup a explicitní binární serializace
Vstup a výstup přenášejí data, zatímco serializace určuje jejich reprezentaci. Naučte se zakódovat celé číslo v pořadí little-endian, bezpečně je dekódovat a doplnit kontrolu zpětného převodu porovnáním se známými bajty.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
serialization: value -> specified bytes; deserialization: validated bytes -> value; round-trip validation: deserialize(serialize(value)) == valueVstup/výstup (I/O) přenáší data mezi programem a jeho okolím. Serializace převádí hodnoty na dohodnutou reprezentaci, zatímco deserializace je po kontrole vstupu obnovuje. Proudy C++ podporují čtení a zápis; samotný přenos bajtů formát dat nedefinuje.
Formát by měl určovat šířky polí, pořadí bajtů a pravidla validace. Pořadí little-endian ukládá nejméně významný bajt jako první: 0x1234 se zakóduje jako 0x34, 0x12. Příklad kóduje jedno 16bitové celé číslo bez znaménka přesně do dvou 8bitových bajtů. Posuny a maskování činí formát nezávislým na pořadí bajtů stroje; vyžaduje CHAR_BIT == 8 a dostupnost volitelného typu std::uint16_t.
Výpis surové paměti objektu není přenositelný formát: jeho reprezentace může obsahovat výplňové bity a záviset na implementaci, a ukazatele neukládají data, na která ukazují. Možnost kopírovat bajty typů trivially copyable nezaručuje kompatibilitu souborů mezi platformami. Ani binární režim souboru nestandardizuje reprezentaci objektu.
Kontrola zpětného převodu ověřuje deserialize(serialize(value)) == value. Příklad navíc porovnává bajty se známým výsledkem, protože dva chybné algoritmy mohou vzájemně kompenzovat své chyby. Dekodér odmítne délky jiné než dvě ještě před přístupem k datům; zde je každá dvoubajtová sekvence platnou hodnotou. Větší formáty potřebují také kontroly rozsahů, délek a verzí a zpracování chyb I/O.
Kód je určen ke kompilaci s příznakem C++23. Zobrazený zdrojový kód byl spuštěn beze změn v izolovaném prostředí a výstup přesně odpovídal uvedenému výsledku. Toto spuštění neověřuje fungování v produkčním prostředí. Zdroj eel.is je průběžně vyvíjený pracovní návrh, nikoli neměnné vydání C++23.
Příklady
#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;
}
Výsledek
bytes: 52 18 round-trip: true known bytes: true invalid length rejected: true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.