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

CKTIS / C++

std::uint8_t — tipo inteiro sem sinal de 8 bits

std::uint8_t de <cstdint> é um alias opcional para um tipo inteiro sem sinal com exatamente 8 bits e um intervalo de 0 a 255. Nos cálculos, está sujeito às promoções de inteiros e, ao ser apresentado, pode comportar-se como um carácter.

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

Sintaxe

#include <cstdint>
std::uint8_t value{42};

std::uint8_t, declarado em <cstdint>, é um alias para um tipo inteiro sem sinal com exatamente 8 bits e sem bits de preenchimento. Armazena valores de 0 a 255. O alias não cria um tipo novo e distinto. É útil para representar valores numéricos de 8 bits, como campos de um protocolo binário.

Este tipo é opcional: uma implementação disponibiliza-o se tiver um tipo inteiro adequado com largura exata e sem bits de preenchimento. Não suponha que existe em todas as plataformas. Quando pelo menos 8 bits são suficientes, considere std::uint_least8_t. O URL do standard fornecido aponta para um projeto de trabalho em evolução, não para uma edição definitiva de C++23.

Em value + 1, o valor de std::uint8_t é promovido a int; assim, quando value é 255, o resultado é 256, não 0. Só a conversão desse resultado para std::uint8_t produz 0: uma conversão inteira para este tipo reduz o valor módulo 256. Não confunda a promoção durante um cálculo com a conversão posterior do respetivo resultado.

std::uint8_t pode ser um alias de unsigned char, pelo que usar diretamente std::cout << value pode apresentar um carácter em vez de um número. Use static_cast<unsigned int>(value) para forçar uma saída numérica. O exemplo mostra o valor inicial, o resultado da adição e o resultado de uma conversão explícita de volta ao tipo de 8 bits.

Exemplos

#include <cstdint>
#include <iostream>

int main() {
    std::uint8_t value{255};
    const auto sum = value + 1;
    const auto wrapped = static_cast<std::uint8_t>(sum);

    std::cout << static_cast<unsigned int>(value) << '\n';
    std::cout << sum << '\n';
    std::cout << static_cast<unsigned int>(wrapped) << '\n';
}

Resultado

255
256
0

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