Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

Entrada/saída e serialização binária explícita

A entrada/saída transfere dados, enquanto a serialização define a sua representação. Aprenda a codificar um inteiro em ordem little-endian, a descodificá-lo em segurança e a complementar a validação de ida e volta com uma verificação de bytes conhecidos.

Versão: C++23; repository compiler flag, production runtime not attested

Sintaxe

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

A entrada/saída (I/O) transfere dados entre um programa e o seu ambiente. A serialização converte valores numa representação acordada, enquanto a desserialização os reconstrói depois de verificar a entrada. Os fluxos de C++ permitem ler e escrever; a transferência de bytes, por si só, não define um formato de dados.

Um formato deve especificar a largura dos campos, a ordem dos bytes e as regras de validação. A ordem little-endian coloca primeiro o byte menos significativo: 0x1234 é codificado como 0x34, 0x12. O exemplo codifica um inteiro sem sinal de 16 bits em exatamente dois bytes de 8 bits. Os deslocamentos e as máscaras tornam o formato independente da ordem dos bytes da máquina; são necessários CHAR_BIT == 8 e a disponibilidade do tipo opcional std::uint16_t.

Escrever a memória bruta de um objeto não é um formato portátil: a representação pode conter bits de preenchimento e depender da implementação, e os apontadores não armazenam os dados para os quais apontam. A permissão para copiar os bytes de tipos trivially copyable não garante ficheiros compatíveis entre plataformas. O modo binário de um ficheiro também não normaliza a representação dos objetos.

A validação de ida e volta verifica deserialize(serialize(value)) == value. O exemplo também compara os bytes com um resultado conhecido, pois dois algoritmos incorretos podem compensar os erros um do outro. O descodificador rejeita comprimentos diferentes de dois antes de aceder aos dados; aqui, qualquer sequência de dois bytes é um valor válido. Os formatos maiores também precisam de verificações de intervalos, comprimentos e versões, além do tratamento de erros de I/O.

O código destina-se a ser compilado com uma opção C++23. O código-fonte apresentado foi executado sem alterações num ambiente isolado e a saída coincidiu exatamente com o resultado indicado. Esta execução não verifica o funcionamento num ambiente de produção. A fonte eel.is é um rascunho de trabalho em evolução, não uma publicação C++23 congelada.

Exemplos

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

Resultado

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

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes