CKTIS / C++
std::uint16_t — liczba całkowita bez znaku o szerokości 16 bitów
std::uint16_t z nagłówka <cstdint> jest opcjonalnym aliasem typu całkowitego bez znaku o dokładnie 16 bitach i zakresie 0–65535. Przydaje się, gdy wymagana jest dokładna szerokość, ale nie gwarantuje dwubajtowego rozmiaru na każdej platformie.
Wersja: C++23; repository compiler flag, production runtime not attested
Składnia
#include <cstdint>
std::uint16_t value{42};std::uint16_t, dostępny po #include <cstdint>, jest aliasem istniejącego typu całkowitego bez znaku, a nie osobnym nowym typem. Ma dokładnie 16 bitów, bez bitów dopełniających, i reprezentuje wartości od 0 do 65535. Nie zakładaj, że zawsze jest aliasem unsigned short.
Ten alias jest opcjonalny: implementacja udostępnia go, jeśli obsługuje typ całkowity o odpowiedniej szerokości bez bitów dopełniających. Jeśli wystarcza co najmniej 16 bitów, wybierz std::uint_least16_t. Dokładnie 16 bitów nie musi oznaczać sizeof(std::uint16_t) == 2, ponieważ sizeof mierzy rozmiar w bajtach C++, które nie muszą mieć 8 bitów.
Konwersja liczby całkowitej do std::uint16_t daje wartość modulo 65536; dlatego static_cast<std::uint16_t>(65536UL) daje 0. Nie oznacza to, że każde działanie na operandach tego typu odbywa się w 16 bitach: promocje całkowitoliczbowe mogą najpierw zmienić typ operandów, często na int. Przed obliczeniami wymagającymi większego zakresu jawnie wybierz odpowiednio szerszy typ.
Przykład pokazuje największą wartość oraz wynik jawnej konwersji. Rzutowania do unsigned long zapewniają wypisywanie liczb niezależnie od typu bazowego aliasu. Kod jest przeznaczony do kompilacji w trybie C++23; sam wybór tego trybu nie potwierdza działania w środowisku produkcyjnym.
Przykłady
#include <cstdint>
#include <iostream>
int main() {
constexpr std::uint16_t maximum{65535};
constexpr auto wrapped = static_cast<std::uint16_t>(65536UL);
static_assert(wrapped == 0);
std::cout << static_cast<unsigned long>(maximum) << '\n'
<< static_cast<unsigned long>(wrapped) << '\n';
}
Wynik
65535 0
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.