CKTIS / C++
std::int32_t — um tipo inteiro com sinal de exatamente 32 bits
std::int32_t de <cstdint> é um alias de um tipo inteiro com sinal com exatamente 32 bits e sem bits de preenchimento. O seu intervalo vai de -2147483648 a 2147483647. A disponibilidade deste alias depende da implementação.
Versão: C++23; repository compiler flag, production runtime not attested
Sintaxe
#include <cstdint>
std::int32_t value{42};std::int32_t, declarado em <cstdint>, é um alias de um tipo inteiro com sinal existente, não um tipo novo e distinto. Tem exatamente 32 bits, não tem bits de preenchimento e usa uma representação em complemento para dois. O seu intervalo vai de -2147483648 a 2147483647, inclusive.
O alias é opcional: uma implementação disponibiliza-o se tiver um tipo correspondente de largura exata e sem bits de preenchimento. Depois de incluir <cstdint>, a macro INT32_MAX permite verificar a sua disponibilidade com #ifdef. O tipo int simples não garante exatamente 32 bits. A largura exata também não significa que sizeof(std::int32_t) == 4 em todas as plataformas, porque um byte C++ não tem necessariamente 8 bits.
Utilize este alias quando for necessária uma largura exata. Se bastarem pelo menos 32 bits, considere std::int_least32_t; este não tem de ter exatamente 32 bits. A aritmética continua sujeita às regras habituais de promoção de inteiros. O overflow do tipo com sinal em que uma operação é executada causa comportamento indefinido — não presuma que os valores dão a volta ao intervalo.
O exemplo subtrai 250 a 1200 e apresenta o resultado e os limites do intervalo através de INT32_MIN e INT32_MAX. Se o alias não estiver disponível, a compilação é interrompida deliberadamente. Esta entrada diz respeito a C++23; a referência fornecida aponta para um projeto de norma em evolução, não para uma publicação C++23 definitiva.
Exemplos
#include <cstdint>
#include <iostream>
#ifndef INT32_MAX
#error "This example requires std::int32_t"
#else
int main() {
std::int32_t balance{1200};
balance -= 250;
std::cout << static_cast<long long>(balance) << '\n';
std::cout << static_cast<long long>(INT32_MIN) << ' ' << static_cast<long long>(INT32_MAX) << '\n';
}
#endif
Resultado
950 -2147483648 2147483647
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.