Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje