Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

Wejście/wyjście i jawna serializacja binarna

Wejście/wyjście przenosi dane, a serializacja określa ich reprezentację. Poznaj zapis liczby w kolejności little-endian, bezpieczne odtwarzanie wartości oraz test odtworzenia uzupełniony kontrolą oczekiwanych bajtów.

Wersja: C++23; repository compiler flag, production runtime not attested

Składnia

serialization: value -> specified bytes; deserialization: validated bytes -> value; round-trip validation: deserialize(serialize(value)) == value

Wejście/wyjście (I/O) przenosi dane między programem a jego otoczeniem. Serializacja (serialization) zamienia wartości na uzgodnioną reprezentację, a deserializacja (deserialization) odtwarza je po sprawdzeniu danych. Strumienie C++ obsługują odczyt i zapis; sam transfer bajtów nie definiuje formatu danych.

Format powinien określać szerokości pól, kolejność bajtów oraz zasady walidacji. Kolejność little-endian (little-endian byte order) umieszcza najmniej znaczący bajt jako pierwszy: 0x1234 zapisujemy jako 0x34, 0x12. Przykład koduje jedną 16-bitową liczbę bez znaku w dokładnie dwóch 8-bitowych bajtach. Przesunięcia i maskowanie uniezależniają format od kolejności bajtów maszyny; wymagane są CHAR_BIT == 8 i dostępność opcjonalnego typu std::uint16_t.

Zapis surowej pamięci obiektu nie jest przenośnym formatem: reprezentacja może zawierać bity wypełnienia i zależeć od implementacji, a wskaźniki nie zapisują wskazywanych danych. Możliwość kopiowania bajtów typów trivially copyable nie gwarantuje zgodności plików między platformami. Tryb binarny pliku również nie standaryzuje reprezentacji obiektu.

Walidacja odtworzenia (round-trip validation) sprawdza deserialize(serialize(value)) == value. Przykład dodatkowo porównuje bajty ze znanym wynikiem, ponieważ dwa błędne algorytmy mogą wzajemnie znosić swoje błędy. Dekoder odrzuca długość inną niż dwa przed dostępem do danych; każdy dwubajtowy ciąg jest tu poprawną wartością. W większych formatach sprawdzaj też zakresy, długości i wersje oraz błędy I/O.

Kod jest przeznaczony do kompilacji z flagą C++23. Wyświetlony kod uruchomiono bez zmian w odizolowanym środowisku i potwierdzono, że jego wyjście jest identyczne z podanym wynikiem. To uruchomienie nie potwierdza działania w środowisku produkcyjnym. Źródło eel.is jest rozwijanym szkicem, a nie zamrożoną publikacją C++23.

Przykłady

#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;
}

Wynik

bytes: 52 18
round-trip: true
known bytes: true
invalid length rejected: true

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła