CKTIS / C++
std::uint8_t — vorzeichenloser 8-Bit-Ganzzahltyp
std::uint8_t aus <cstdint> ist ein optionaler Alias für einen vorzeichenlosen Ganzzahltyp mit genau 8 Bits und einem Wertebereich von 0 bis 255. Bei Berechnungen unterliegt er den Ganzzahl-Promotions und kann bei der Ausgabe wie ein Zeichen behandelt werden.
Version: C++23; repository compiler flag, production runtime not attested
Syntax
#include <cstdint>
std::uint8_t value{42};std::uint8_t, deklariert in <cstdint>, ist ein Alias für einen vorzeichenlosen Ganzzahltyp mit genau 8 Bits und ohne Füllbits. Er kann Werte von 0 bis 255 speichern. Der Alias erzeugt keinen neuen, eigenständigen Typ. Er eignet sich zur Darstellung numerischer 8-Bit-Werte, etwa von Feldern in einem Binärprotokoll.
Dieser Typ ist optional: Eine Implementierung stellt ihn bereit, wenn sie einen geeigneten Ganzzahltyp mit genau dieser Breite und ohne Füllbits besitzt. Gehe nicht davon aus, dass er auf jeder Plattform verfügbar ist. Wenn mindestens 8 Bits ausreichen, ziehe std::uint_least8_t in Betracht. Die angegebene Standard-URL verweist auf einen fortlaufend weiterentwickelten Arbeitsentwurf, nicht auf eine unveränderliche C++23-Ausgabe.
Bei value + 1 wird der Wert von std::uint8_t zu int hochgestuft. Wenn value also 255 ist, beträgt das Ergebnis 256 und nicht 0. Erst die Umwandlung dieses Ergebnisses in std::uint8_t ergibt 0: Eine Ganzzahlkonvertierung in diesen Typ reduziert den Wert modulo 256. Verwechsle die Promotion während einer Berechnung nicht mit der späteren Konvertierung ihres Ergebnisses.
std::uint8_t kann ein Alias für unsigned char sein. Daher kann std::cout << value direkt verwendet ein Zeichen statt einer Zahl ausgeben. Verwende static_cast<unsigned int>(value), um eine numerische Ausgabe zu erzwingen. Das Beispiel zeigt den Anfangswert, das Ergebnis der Addition und das Ergebnis einer expliziten Rückkonvertierung zum 8-Bit-Typ.
Beispiele
#include <cstdint>
#include <iostream>
int main() {
std::uint8_t value{255};
const auto sum = value + 1;
const auto wrapped = static_cast<std::uint8_t>(sum);
std::cout << static_cast<unsigned int>(value) << '\n';
std::cout << sum << '\n';
std::cout << static_cast<unsigned int>(wrapped) << '\n';
}
Ergebnis
255 256 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.