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.