CKTIS / C++
std::int32_t — un type entier signé sur exactement 32 bits
std::int32_t de <cstdint> est un alias d’un type entier signé qui comporte exactement 32 bits, sans bits de remplissage. Son intervalle va de -2147483648 à 2147483647. La disponibilité de cet alias dépend de l’implémentation.
Version : C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <cstdint>
std::int32_t value{42};std::int32_t, déclaré dans <cstdint>, est un alias d’un type entier signé existant, et non un nouveau type distinct. Il comporte exactement 32 bits, sans bits de remplissage, et utilise une représentation en complément à deux. Son intervalle va de -2147483648 à 2147483647 inclus.
Cet alias est facultatif : une implémentation le fournit si elle dispose d’un type correspondant de largeur exacte et sans bits de remplissage. Après avoir inclus <cstdint>, la macro INT32_MAX permet de vérifier sa disponibilité avec #ifdef. Le type int simple ne garantit pas exactement 32 bits. Une largeur exacte ne signifie pas non plus que sizeof(std::int32_t) == 4 sur toutes les plateformes, car un octet C++ ne contient pas nécessairement 8 bits.
Utilisez cet alias lorsqu’une largeur exacte est nécessaire. Si 32 bits au minimum suffisent, envisagez std::int_least32_t ; il n’est pas nécessaire qu’il fasse exactement 32 bits. L’arithmétique reste soumise aux règles habituelles de promotion des entiers. Un dépassement de capacité du type signé dans lequel une opération est effectuée entraîne un comportement indéfini : ne supposez pas un retour cyclique des valeurs.
L’exemple soustrait 250 à 1200 et affiche le résultat ainsi que les limites de l’intervalle avec INT32_MIN et INT32_MAX. Si l’alias n’est pas disponible, la compilation est volontairement interrompue. Cette fiche porte sur C++23 ; la référence fournie mène à un projet de norme en évolution, et non à une publication C++23 figée.
Exemples
#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
Résultat
950 -2147483648 2147483647
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.