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

CKTIS / C++

std::byte — um byte sem semântica numérica

std::byte de <cstddef> representa dados brutos em bytes. É um tipo enumerado distinto, não um alias de unsigned char. Suporta operações bit a bit, mas não aritmética comum nem conversões implícitas para tipos inteiros.

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

Sintaxe

#include <cstddef>

std::byte b{0x2A};
auto masked = b & std::byte{0x0F};
auto value = std::to_integer<unsigned int>(masked);

std::byte é declarado em <cstddef>, no espaço de nomes std, como enum class byte : unsigned char {};. Utilize-o quando um valor representar dados brutos em bytes, em vez de um carácter de texto ou de um número destinado a cálculos. É um tipo distinto, não um alias de unsigned char.

A declaração std::byte b{0x2A}; inicializa diretamente um byte a partir de um inteiro. Esta inicialização exige uma conversão não redutora para o tipo subjacente. A declaração std::byte b = 42; é inválida: não existe uma conversão implícita a partir de um inteiro. Para converter no sentido inverso, faça-o explicitamente, por exemplo com std::to_integer<unsigned int>(b); o argumento do modelo tem de ser um tipo inteiro.

Os operadores binários &, |, ^, << e >> têm os respetivos operadores de atribuição composta: &=, |=, ^=, <<= e >>=. Também está disponível o operador unário de complemento bit a bit ~, que não tem uma forma de atribuição composta. Todas estas operações são constexpr e noexcept. O número de posições do deslocamento tem de ser de tipo inteiro. A aritmética comum, como b + b ou ++b, não é suportada.

O exemplo aplica a máscara 0x0F a 0x2A, deixando o valor 10. Antes de ser impresso, o resultado é convertido através de std::to_integer<unsigned int>(low); a biblioteca não disponibiliza um operador de inserção direto para escrever std::byte em std::cout.

Exemplos

#include <cstddef>
#include <iostream>

int main() {
    constexpr std::byte value{0x2A};
    constexpr std::byte mask{0x0F};
    constexpr std::byte low = value & mask;
    static_assert(std::to_integer<unsigned int>(low) == 10u);

    std::cout << std::to_integer<unsigned int>(low) << '\n';
}

Resultado

10

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