CKTIS / C++
std::int8_t — dokładnie 8-bitowa liczba całkowita ze znakiem
std::int8_t z <cstdint> jest opcjonalnym aliasem typu całkowitego ze znakiem o dokładnie 8 bitach, bez bitów dopełniających. Przechowuje wartości od -128 do 127. Obliczenia podlegają promocjom całkowitoliczbowym, a przy wypisywaniu warto jawnie przekształcić wartość do int.
Wersja: C++23; repository compiler flag, production runtime not attested
Składnia
#include <cstdint>
std::int8_t value{42};std::int8_t, udostępniany przez <cstdint>, jest aliasem istniejącego typu, a nie nowym, odrębnym typem. Ma dokładnie 8 bitów, bez bitów dopełniających, i zakres od -128 do 127. Jest opcjonalny: implementacja musi go udostępnić, jeśli ma odpowiedni typ całkowity. Po dołączeniu nagłówka makro INT8_MAX pozwala sprawdzić jego dostępność.
Używaj go, gdy wymagana jest dokładna szerokość. Jeśli wystarczy co najmniej 8 bitów, wybierz std::int_least8_t; std::uint8_t jest natomiast opcjonalnym typem bez znaku o zakresie od 0 do 255. std::int8_t może być aliasem signed char. W kodzie C++23 bezpośrednie wypisanie przez std::cout może więc potraktować wartość jak znak; static_cast<int>(value) jednoznacznie żąda wyniku liczbowego.
W wyrażeniu value + 7 wartość std::int8_t jest promowana do int, więc wynik także ma typ int. Przed zapisaniem wyniku z powrotem sprawdź zakres: jawna konwersja nie zgłasza błędu przekroczenia zakresu. W C++23 konwersja liczby całkowitej do tego typu daje wartość przystającą modulo 256, a nie wartość ograniczoną do najbliższej granicy zakresu.
Przykład przechowuje 120, oblicza 127 w int i zapisuje reprezentowalny wynik z powrotem. Oczekiwane wyjście to 120 127 127 z końcowym znakiem nowego wiersza. Materiał dotyczy C++23; podany projekt standardu jest aktualizowany i nie stanowi zamrożonego wydania C++23. Tryb kompilacji repozytorium nie potwierdza zachowania środowiska produkcyjnego.
Przykłady
#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
Wynik
120 127 127
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.