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

CKTIS / C++

std::int8_t — um inteiro com sinal de exatamente 8 bits

std::int8_t de <cstdint> é um alias opcional para um tipo inteiro com sinal com exatamente 8 bits e sem bits de preenchimento. Armazena valores de -128 a 127. Os cálculos seguem as regras de promoção de inteiros; uma conversão explícita para int é útil para apresentar o seu valor numérico.

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

Sintaxe

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

std::int8_t, disponibilizado por <cstdint>, é um alias de um tipo existente, não um tipo novo e distinto. Tem exatamente 8 bits, não tem bits de preenchimento e abrange valores de -128 a 127. É opcional: uma implementação tem de o disponibilizar se possuir um tipo inteiro adequado. Depois de incluir o cabeçalho, a macro INT8_MAX permite verificar a sua disponibilidade.

Utilize-o quando for necessária uma largura exata. Se forem suficientes pelo menos 8 bits, escolha std::int_least8_t; std::uint8_t, por sua vez, é um tipo sem sinal opcional com valores de 0 a 255. std::int8_t pode ser um alias de signed char. Em C++23, inseri-lo diretamente em std::cout pode, por isso, fazer com que o valor seja tratado como um carácter; static_cast<int>(value) pede inequivocamente uma saída numérica.

Em value + 7, o valor std::int8_t é promovido para int, pelo que o resultado também é do tipo int. Verifique o intervalo antes de voltar a guardar o resultado: uma conversão explícita não comunica que o valor está fora do intervalo. Em C++23, converter um inteiro para este tipo produz o valor congruente módulo 256, em vez de o limitar ao limite mais próximo do intervalo.

O exemplo guarda 120, calcula 127 como int e volta a guardar o resultado representável. A saída esperada é 120 127 127, seguida de uma mudança de linha. Este material aborda C++23; o projeto de trabalho fornecido evolui e não é uma edição C++23 fixa. O modo de compilação do repositório não atesta o comportamento num ambiente de produção.

Exemplos

#include <cstdint>
#include <iostream>

#ifndef INT8_MAX
#error "This example requires std::int8_t"
#else
int main() {
    std::int8_t value{120};
    int sum = value + 7;
    std::int8_t result{static_cast<std::int8_t>(sum)};
    std::cout << static_cast<int>(value) << ' '
              << sum << ' ' << static_cast<int>(result) << '\n';
}
#endif

Resultado

120 127 127

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