Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::uint64_t — 64-bitowa liczba całkowita bez znaku

std::uint64_t z nagłówka <cstdint> jest opcjonalnym aliasem typu całkowitego bez znaku o dokładnie 64 bitach i bez bitów dopełnienia. Przechowuje wartości od 0 do 18446744073709551615.

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

Składnia

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

std::uint64_t to alias istniejącego typu, a nie osobny nowy typ. Dołącz <cstdint> i deklaruj zmienne jako std::uint64_t name{value};. Dokładna szerokość przydaje się, gdy format danych wymaga 64-bitowych wartości nieujemnych.

Typ jest opcjonalny: implementacja udostępnia go, jeżeli ma odpowiedni typ o dokładnie 64 bitach bez bitów dopełnienia. Makro UINT64_MAX jest dostępne wtedy, gdy istnieje ten alias. Nie zakładaj, że alias zawsze oznacza unsigned long long.

Zakres wynosi od 0 do 18446744073709551615, czyli 2^64 − 1. Arytmetyka wykonywana w typie std::uint64_t działa modulo 2^64, ale promocje całkowitoliczbowe mogą zmienić typ, w którym wykonywane jest działanie. Jeżeli std::uint64_t podlega promocji do int, a INT_MAX jest równe UINT64_MAX, bezpośrednie zwiększenie wartości maksymalnej o 1 powoduje przepełnienie typu int ze znakiem, a zachowanie jest niezdefiniowane. Nawet gdy przejście do zera jest dobrze zdefiniowane, może oznaczać błąd w logice programu. Dokładna szerokość nie określa kolejności bajtów przy zapisie binarnym.

Przykład wypisuje maksimum, dodaje 1ULL do wartości value przekształconej na unsigned long long, a następnie przekształca wynik z powrotem na std::uint64_t. Dodawanie odbywa się w typie bez znaku, a konwersja z powrotem daje wynik modulo 2^64, więc przykład wypisuje 0. Warunek #ifndef UINT64_MAX zapewnia czytelny błąd na implementacji bez tego opcjonalnego typu. Wskazane źródło jest rozwijanym szkicem standardu, a nie zamrożonym wydaniem C++23.

Przykłady

#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

Wynik

18446744073709551615
0

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła