CKTIS / C++
Вход/изход и изрична двоична сериализация
Входът и изходът пренасят данни, а сериализацията определя тяхното представяне. Научете как да кодирате цяло число в ред little-endian, да го декодирате безопасно и да допълните проверката на обратния цикъл със сравнение с известни байтове.
Версия: C++23; repository compiler flag, production runtime not attested
Синтаксис
serialization: value -> specified bytes; deserialization: validated bytes -> value; round-trip validation: deserialize(serialize(value)) == valueВходът/изходът (I/O) пренася данни между програма и нейната среда. Сериализацията преобразува стойности в договорено представяне, а десериализацията ги възстановява след проверка на входа. Потоковете в C++ поддържат четене и запис; самото пренасяне на байтове не определя формат на данните.
Форматът трябва да задава ширините на полетата, реда на байтовете и правилата за проверка. Редът little-endian поставя най-младшия байт първи: 0x1234 се кодира като 0x34, 0x12. Примерът кодира едно 16-битово беззнаково цяло число точно в два 8-битови байта. Отместванията и маскирането правят формата независим от реда на байтовете на машината; необходими са CHAR_BIT == 8 и наличието на незадължителния тип std::uint16_t.
Извеждането на суровата памет на обект не е преносим формат: представянето му може да съдържа битове за запълване и да зависи от реализацията, а указателите не съхраняват данните, към които сочат. Разрешението за копиране на байтовете на типове trivially copyable не гарантира съвместими файлове между платформи. Бинарният режим на файл също не стандартизира представянето на обектите.
Проверката на обратния цикъл проверява deserialize(serialize(value)) == value. Примерът сравнява байтовете и с известен резултат, защото два неправилни алгоритъма могат да компенсират грешките си. Декодерът отхвърля дължини, различни от две, преди да получи достъп до данните; тук всяка последователност от два байта е валидна стойност. По-големите формати изискват и проверки на диапазони, дължини и версии, както и обработка на I/O грешки.
Кодът е предназначен за компилиране с флаг C++23. Показаният изходен код е изпълнен без промени в изолирана среда и изходът съвпада точно с посочения резултат. Това изпълнение не потвърждава работата в производствена среда. Източникът eel.is е развиващ се работен проект, а не замразена публикация на C++23.
Примери
#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;
}
Резултат
bytes: 52 18 round-trip: true known bytes: true invalid length rejected: true
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.