CKTIS / C++
std::uint16_t — celé číslo bez znaménka s přesně 16 bity
std::uint16_t z <cstdint> je volitelný alias pro celočíselný typ bez znaménka s přesně 16 bity a rozsahem 0 až 65535. Hodí se, když je vyžadována přesná šířka, ale nezaručuje velikost dvou bajtů na každé platformě.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <cstdint>
std::uint16_t value{42};std::uint16_t, dostupný po #include <cstdint>, je alias existujícího celočíselného typu bez znaménka, nikoli samostatný nový typ. Má přesně 16 bitů, žádné výplňové bity a reprezentuje hodnoty od 0 do 65535. Nepředpokládejte, že je vždy aliasem typu unsigned short.
Tento alias je volitelný: implementace jej poskytuje, pokud podporuje celočíselný typ s odpovídající šířkou a bez výplňových bitů. Pokud stačí alespoň 16 bitů, zvolte std::uint_least16_t. Přesně 16 bitů nemusí znamenat, že sizeof(std::uint16_t) == 2, protože sizeof měří bajty C++, které nemusí obsahovat 8 bitů.
Převod celého čísla na std::uint16_t vytvoří jeho hodnotu modulo 65536; proto static_cast<std::uint16_t>(65536UL) vytvoří 0. To neznamená, že každá operace s operandy tohoto typu používá 16bitovou aritmetiku: celočíselné promoci mohou nejprve změnit typy operandů, často na int. Pro výpočty vyžadující větší rozsah výslovně zvolte dostatečně širší typ.
Příklad ukazuje maximální hodnotu a výsledek explicitního převodu. Převody na unsigned long zajišťují číselný výstup bez ohledu na podkladový typ aliasu. Kód je určen ke kompilaci v režimu C++23; samotná volba tohoto režimu nepotvrzuje funkčnost v produkčním běhovém prostředí.
Příklady
#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';
}
Výsledek
65535 0
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.