Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::uint8_t — 8-bitowy typ całkowity bez znaku

std::uint8_t z nagłówka <cstdint> jest opcjonalnym aliasem typu całkowitego bez znaku o dokładnie 8 bitach i zakresie 0–255. Przy obliczeniach podlega promocjom całkowitoliczbowym, a przy wypisywaniu może zachowywać się jak znak.

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

Składnia

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

std::uint8_t, zadeklarowany w <cstdint>, jest aliasem typu całkowitego bez znaku o dokładnie 8 bitach, bez bitów dopełniających. Przechowuje wartości od 0 do 255. Alias nie tworzy nowego, odrębnego typu. Przydaje się do reprezentowania 8-bitowych wartości liczbowych, na przykład pól protokołu binarnego.

Ten typ jest opcjonalny: implementacja udostępnia go, jeżeli ma odpowiedni typ całkowity o dokładnej szerokości i bez bitów dopełniających. Nie zakładaj jego obecności na każdej platformie. Gdy wystarcza co najmniej 8 bitów, rozważ std::uint_least8_t. Podany adres standardu prowadzi do rozwijanego szkicu, a nie zamrożonego wydania C++23.

W wyrażeniu value + 1 wartość std::uint8_t jest promowana do int, więc dla value równego 255 wynik wynosi 256, a nie 0. Dopiero konwersja tego wyniku do std::uint8_t daje 0: konwersja całkowitoliczbowa do tego typu sprowadza wartość modulo 256. Nie należy mylić promocji podczas obliczeń z późniejszą konwersją wyniku.

std::uint8_t może być aliasem unsigned char, dlatego bezpośrednie użycie std::cout << value może wypisać znak zamiast liczby. Użyj static_cast<unsigned int>(value), aby wymusić wypisanie liczby. Przykład pokazuje wartość początkową, wynik dodawania oraz wynik jawnej konwersji z powrotem do typu 8-bitowego.

Przykłady

#include <cstdint>
#include <iostream>

int main() {
    std::uint8_t value{255};
    const auto sum = value + 1;
    const auto wrapped = static_cast<std::uint8_t>(sum);

    std::cout << static_cast<unsigned int>(value) << '\n';
    std::cout << sum << '\n';
    std::cout << static_cast<unsigned int>(wrapped) << '\n';
}

Wynik

255
256
0

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła