CKTIS / C++
Ulaz/izlaz i izričita binarna serijalizacija
Ulaz i izlaz prenose podatke, dok serijalizacija određuje njihov prikaz. Naučite kodirati cijeli broj redoslijedom little-endian, sigurno ga dekodirati i provjeru povratnog ciklusa dopuniti usporedbom s poznatim bajtovima.
Verzija: C++23; repository compiler flag, production runtime not attested
Sintaksa
serialization: value -> specified bytes; deserialization: validated bytes -> value; round-trip validation: deserialize(serialize(value)) == valueUlaz/izlaz (I/O) prenosi podatke između programa i njegova okruženja. Serijalizacija pretvara vrijednosti u dogovoreni prikaz, a deserijalizacija ih rekonstruira nakon provjere ulaza. C++ tokovi podržavaju čitanje i pisanje; samo prenošenje bajtova ne definira format podataka.
Format bi trebao odrediti širine polja, redoslijed bajtova i pravila provjere. Redoslijed little-endian stavlja najmanje značajan bajt na prvo mjesto: 0x1234 kodira se kao 0x34, 0x12. Primjer kodira jedan 16-bitni cijeli broj bez predznaka u točno dva 8-bitna bajta. Pomaci i maskiranje čine format neovisnim o redoslijedu bajtova stroja; potrebni su CHAR_BIT == 8 i dostupnost izbornog tipa std::uint16_t.
Ispis sirove memorije objekta nije prenosiv format: njegov prikaz može sadržavati bitove za popunu i ovisiti o implementaciji, a pokazivači ne pohranjuju podatke na koje pokazuju. Mogućnost kopiranja bajtova tipova trivially copyable ne jamči kompatibilnost datoteka među platformama. Ni binarni način rada datoteke ne standardizira prikaz objekata.
Provjera povratnog ciklusa provjerava deserialize(serialize(value)) == value. Primjer dodatno uspoređuje bajtove s poznatim rezultatom jer dva neispravna algoritma mogu međusobno poništiti svoje pogreške. Dekoder odbacuje duljine različite od dvije prije pristupa podacima; ovdje je svaki niz od dva bajta valjana vrijednost. Veći formati zahtijevaju i provjere raspona, duljina i verzija te obradu pogrešaka I/O.
Kod je namijenjen kompiliranju sa zastavicom C++23. Prikazani izvorni kod pokrenut je bez izmjena u izoliranom okruženju, a ispis se točno podudarao s navedenim rezultatom. To pokretanje ne potvrđuje rad u produkcijskom okruženju. Izvor eel.is radni je nacrt koji se razvija, a ne zamrznuta objava C++23.
Primjeri
#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;
}
Rezultat
bytes: 52 18 round-trip: true known bytes: true invalid length rejected: true
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.