CKTIS / C++
std::uint16_t — eine vorzeichenlose Ganzzahl mit genau 16 Bits
std::uint16_t aus <cstdint> ist ein optionaler Alias für einen vorzeichenlosen Ganzzahltyp mit genau 16 Bits und einem Wertebereich von 0 bis 65535. Er ist nützlich, wenn eine exakte Bitbreite erforderlich ist, garantiert aber nicht auf jeder Plattform eine Größe von zwei Bytes.
Version: C++23; repository compiler flag, production runtime not attested
Syntax
#include <cstdint>
std::uint16_t value{42};std::uint16_t, verfügbar nach #include <cstdint>, ist ein Alias für einen vorhandenen vorzeichenlosen Ganzzahltyp und kein eigenständiger neuer Typ. Er hat genau 16 Bits, keine Padding-Bits und stellt Werte von 0 bis 65535 dar. Gehe nicht davon aus, dass er immer ein Alias für unsigned short ist.
Dieser Alias ist optional: Eine Implementierung stellt ihn bereit, wenn sie einen Ganzzahltyp mit der entsprechenden Bitbreite und ohne Padding-Bits unterstützt. Wenn mindestens 16 Bits ausreichen, wähle std::uint_least16_t. Genau 16 Bits bedeuten nicht zwangsläufig, dass sizeof(std::uint16_t) == 2 gilt, denn sizeof misst C++-Bytes, die nicht unbedingt 8 Bits enthalten.
Die Umwandlung einer Ganzzahl in std::uint16_t ergibt ihren Wert modulo 65536; daher ergibt static_cast<std::uint16_t>(65536UL) den Wert 0. Das bedeutet nicht, dass jede Operation mit Operanden dieses Typs mit 16-Bit-Arithmetik ausgeführt wird: Ganzzahl-Promotions können die Operanden zunächst in andere Typen umwandeln, häufig in int. Wähle für Berechnungen, die einen größeren Wertebereich erfordern, ausdrücklich einen entsprechend breiteren Typ.
Das Beispiel zeigt den Höchstwert und das Ergebnis einer expliziten Umwandlung. Umwandlungen in unsigned long sorgen unabhängig vom zugrunde liegenden Typ des Alias für eine numerische Ausgabe. Der Code ist für die Kompilierung mit C++23 vorgesehen; allein die Wahl dieses Modus bestätigt nicht, dass er in einer Produktionslaufzeitumgebung funktioniert.
Beispiele
#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';
}
Ergebnis
65535 0
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.