Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::int32_t — un tipo intero con segno di esattamente 32 bit

std::int32_t di <cstdint> è un alias di un tipo intero con segno di esattamente 32 bit e senza bit di riempimento. Il suo intervallo va da -2147483648 a 2147483647. La disponibilità dell’alias dipende dall’implementazione.

Versione: C++23; repository compiler flag, production runtime not attested

Sintassi

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

std::int32_t, dichiarato in <cstdint>, è un alias di un tipo intero con segno già esistente, non un nuovo tipo distinto. Ha esattamente 32 bit, nessun bit di riempimento e una rappresentazione in complemento a due. Il suo intervallo va da -2147483648 a 2147483647 inclusi.

L’alias è facoltativo: un’implementazione lo fornisce se dispone di un tipo corrispondente con larghezza esatta e senza bit di riempimento. Dopo aver incluso <cstdint>, la macro INT32_MAX consente di verificarne la disponibilità con #ifdef. Il semplice tipo int non garantisce esattamente 32 bit. La larghezza esatta non significa neppure che sizeof(std::int32_t) == 4 su ogni piattaforma, perché un byte C++ non deve necessariamente contenere 8 bit.

Usa questo alias quando è necessaria una larghezza esatta. Se sono sufficienti almeno 32 bit, considera std::int_least32_t; non è necessario che abbia esattamente 32 bit. L’aritmetica continua a seguire le normali regole di promozione degli interi. L’overflow del tipo con segno in cui viene eseguita un’operazione causa un comportamento indefinito: non dare per scontato il ritorno circolare dei valori.

L’esempio sottrae 250 da 1200 e stampa il risultato e i limiti dell’intervallo tramite INT32_MIN e INT32_MAX. Se l’alias non è disponibile, la compilazione viene interrotta intenzionalmente. Questa scheda riguarda C++23; il riferimento fornito rimanda a una bozza di standard in evoluzione, non a una pubblicazione C++23 definitiva.

Esempi

#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

Risultato

950
-2147483648 2147483647

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti