WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::uint64_t — vorzeichenlose 64-Bit-Ganzzahl

std::uint64_t aus <cstdint> ist ein optionaler Alias für einen vorzeichenlosen Ganzzahltyp mit genau 64 Bits und ohne Füllbits. Er speichert Werte von 0 bis 18446744073709551615.

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

Syntax

#include <cstdint>
std::uint64_t name{value};

std::uint64_t ist ein Alias für einen vorhandenen Typ und kein eigenständiger neuer Typ. Binde <cstdint> ein und deklariere Variablen als std::uint64_t name{value};. Die exakte Bitbreite ist nützlich, wenn ein Datenformat nichtnegative Werte mit 64 Bits erfordert.

Der Typ ist optional: Eine Implementierung stellt ihn bereit, wenn sie einen passenden Typ mit genau 64 Bits und ohne Füllbits besitzt. Das Makro UINT64_MAX ist verfügbar, wenn dieser Alias existiert. Gehe nicht davon aus, dass der Alias immer unsigned long long bezeichnet.

Der Wertebereich reicht von 0 bis 18446744073709551615, also 2^64 − 1. Wird eine Berechnung im Typ std::uint64_t ausgeführt, erfolgt sie modulo 2^64. Ganzzahlpromotionen können jedoch den Typ ändern, in dem gerechnet wird. Wird std::uint64_t zu int promoviert und ist INT_MAX gleich UINT64_MAX, führt das direkte Erhöhen des Höchstwerts um 1 zu einem Überlauf des vorzeichenbehafteten Typs int und damit zu undefiniertem Verhalten. Auch ein wohldefinierter Überlauf auf null kann auf einen Fehler in der Programmlogik hindeuten. Die exakte Bitbreite legt die Byte-Reihenfolge bei der binären Speicherung nicht fest.

Das Beispiel gibt den Höchstwert aus, wandelt value in unsigned long long um, addiert 1ULL und wandelt das Ergebnis zurück in std::uint64_t. Die Addition erfolgt in einem vorzeichenlosen Typ, und die Rückumwandlung liefert das Ergebnis modulo 2^64. Deshalb gibt das Beispiel 0 aus. Die Bedingung #ifndef UINT64_MAX sorgt bei Implementierungen ohne diesen optionalen Typ für eine verständliche Fehlermeldung. Die angegebene Quelle ist ein fortlaufend überarbeiteter Standardentwurf und keine unveränderliche C++23-Ausgabe.

Beispiele

#include <cstdint>
#include <iostream>

#ifndef UINT64_MAX
#error "This example requires std::uint64_t"
#else
int main() {
    std::uint64_t value{UINT64_MAX};
    std::cout << static_cast<unsigned long long>(value) << '\n';
    value = static_cast<std::uint64_t>(static_cast<unsigned long long>(value) + 1ULL);
    std::cout << static_cast<unsigned long long>(value) << '\n';
}
#endif

Ergebnis

18446744073709551615
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.

Quellen