KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::uint16_t — een geheel getal zonder teken van precies 16 bits

std::uint16_t uit <cstdint> is een optionele alias voor een geheel-getaltype zonder teken met precies 16 bits en een bereik van 0 tot en met 65535. Het is nuttig wanneer een exacte breedte vereist is, maar garandeert niet op elk platform een grootte van twee bytes.

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

Syntax

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

std::uint16_t, beschikbaar na #include <cstdint>, is een alias voor een bestaand geheel-getaltype zonder teken en geen afzonderlijk nieuw type. Het heeft precies 16 bits, geen opvulbits, en kan waarden van 0 tot en met 65535 weergeven. Ga er niet van uit dat het altijd een alias voor unsigned short is.

Deze alias is optioneel: een implementatie biedt hem aan als die een geheel-getaltype met de overeenkomstige breedte en zonder opvulbits ondersteunt. Als ten minste 16 bits volstaan, kies dan std::uint_least16_t. Precies 16 bits betekent niet noodzakelijk dat sizeof(std::uint16_t) == 2, want sizeof meet C++-bytes, die niet per se 8 bits bevatten.

Een geheel getal converteren naar std::uint16_t levert de waarde modulo 65536 op; daarom levert static_cast<std::uint16_t>(65536UL) 0 op. Dat betekent niet dat elke bewerking met operanden van dit type 16-bits rekenkunde gebruikt: integerpromoties kunnen de operandtypen eerst wijzigen, vaak in int. Kies voor berekeningen die een groter bereik vereisen expliciet een passend breder type.

Het voorbeeld toont de maximale waarde en het resultaat van een expliciete conversie. Conversies naar unsigned long zorgen voor numerieke uitvoer, ongeacht het onderliggende type van de alias. De code is bedoeld om met C++23 te worden gecompileerd; alleen het kiezen van die modus bevestigt niet dat de code in een productieomgeving werkt.

Voorbeelden

#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';
}

Resultaat

65535
0

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen