CKTIS / C++
Vstup/výstup a explicitná binárna serializácia
Vstup a výstup prenášajú údaje, zatiaľ čo serializácia určuje ich reprezentáciu. Naučte sa zakódovať celé číslo v poradí little-endian, bezpečne ho dekódovať a doplniť kontrolu spätného prevodu porovnaním so známymi bajtmi.
Verzia: C++23; repository compiler flag, production runtime not attested
Syntax
serialization: value -> specified bytes; deserialization: validated bytes -> value; round-trip validation: deserialize(serialize(value)) == valueVstup/výstup (I/O) prenáša údaje medzi programom a jeho okolím. Serializácia prevádza hodnoty na dohodnutú reprezentáciu a deserializácia ich po kontrole vstupu obnovuje. Prúdy C++ podporujú čítanie a zápis; samotný prenos bajtov nedefinuje formát údajov.
Formát by mal určovať šírky polí, poradie bajtov a pravidlá validácie. Poradie little-endian ukladá najmenej významný bajt ako prvý: 0x1234 sa zakóduje ako 0x34, 0x12. Príklad kóduje jedno 16-bitové celé číslo bez znamienka presne do dvoch 8-bitových bajtov. Posuny a maskovanie robia formát nezávislým od poradia bajtov stroja; vyžaduje CHAR_BIT == 8 a dostupnosť voliteľného typu std::uint16_t.
Výpis surovej pamäte objektu nie je prenositeľný formát: jeho reprezentácia môže obsahovať výplňové bity a závisieť od implementácie, pričom ukazovatele neukladajú údaje, na ktoré ukazujú. Možnosť kopírovať bajty typov trivially copyable nezaručuje kompatibilitu súborov medzi platformami. Ani binárny režim súboru neštandardizuje reprezentáciu objektu.
Kontrola spätného prevodu overuje deserialize(serialize(value)) == value. Príklad navyše porovnáva bajty so známym výsledkom, pretože dva nesprávne algoritmy môžu vzájomne kompenzovať svoje chyby. Dekodér odmietne dĺžky iné ako dve ešte pred prístupom k údajom; tu je každá dvojbajtová sekvencia platnou hodnotou. Väčšie formáty potrebujú aj kontroly rozsahov, dĺžok a verzií a spracovanie chýb I/O.
Kód je určený na kompiláciu s príznakom C++23. Zobrazený zdrojový kód bol spustený bez zmien v izolovanom prostredí a výstup sa presne zhodoval s uvedeným výsledkom. Toto spustenie neoveruje fungovanie v produkčnom prostredí. Zdroj eel.is je priebežne vyvíjaný pracovný návrh, nie zmrazené vydanie C++23.
Prí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ýsledok
bytes: 52 18 round-trip: true known bytes: true invalid length rejected: true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.