CKTIS / C++
std::int32_t — dokładnie 32-bitowy typ całkowity ze znakiem
std::int32_t z nagłówka <cstdint> jest aliasem typu całkowitego ze znakiem o dokładnie 32 bitach, bez bitów dopełniających. Obejmuje wartości od -2147483648 do 2147483647. Jego dostępność zależy od implementacji.
Wersja: C++23; repository compiler flag, production runtime not attested
Składnia
#include <cstdint>
std::int32_t value{42};std::int32_t, deklarowany w <cstdint>, jest aliasem istniejącego typu całkowitego ze znakiem, a nie nowym, odrębnym typem. Ma dokładnie 32 bity, bez bitów dopełniających, i reprezentację w kodzie uzupełnień do dwóch. Jego zakres wynosi od -2147483648 do 2147483647 włącznie.
Ten alias jest opcjonalny: implementacja udostępnia go, jeśli ma odpowiedni typ o dokładnej szerokości i bez bitów dopełniających. Po dołączeniu <cstdint> makro INT32_MAX pozwala sprawdzić jego dostępność w dyrektywie #ifdef. Sam int nie gwarantuje dokładnie 32 bitów. Dokładna szerokość nie oznacza też, że sizeof(std::int32_t) == 4 na każdej platformie, ponieważ bajt C++ nie musi mieć 8 bitów.
Używaj tego aliasu, gdy wymagana jest dokładna szerokość. Jeśli wystarczy co najmniej 32 bity, rozważ std::int_least32_t; nie musi on mieć dokładnie 32 bitów. Arytmetyka nadal podlega zwykłym regułom promocji liczb całkowitych. Przepełnienie typu ze znakiem, w którym wykonywane jest działanie, powoduje niezdefiniowane zachowanie — nie zakładaj zawijania wartości.
Przykład odejmuje 250 od 1200 i wypisuje wynik oraz granice zakresu przez INT32_MIN i INT32_MAX. Jeżeli alias nie jest dostępny, kompilacja zostaje celowo przerwana. Wpis dotyczy C++23; podany odnośnik prowadzi do rozwijanego szkicu standardu, a nie zamrożonej publikacji C++23.
Przykłady
#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
Wynik
950 -2147483648 2147483647
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.