Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::uintptr_t — liczba całkowita przechowująca wartość wskaźnika

std::uintptr_t z <cstdint> jest typem całkowitym bez znaku umożliwiającym konwersję poprawnego void* na liczbę i z powrotem bez utraty wartości wskaźnika. W C++23 jest opcjonalny; nie określa stałej szerokości ani przenośnego formatu adresu.

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

Składnia

#include <cstdint>

std::uintptr_t bits = reinterpret_cast<std::uintptr_t>(ptr);
void* restored = reinterpret_cast<void*>(bits);

std::uintptr_t z <cstdint> jest aliasem typu całkowitego bez znaku, który pozwala przekonwertować poprawny void* na liczbę, a następnie z powrotem na void* porównujący się jako równy pierwotnemu wskaźnikowi. W C++23 ten typ jest opcjonalny; dostępność można sprawdzić przez #if defined(UINTPTR_MAX) po dołączeniu nagłówka. Podany odnośnik prowadzi do rozwijanego szkicu standardu, który obecnie wymaga tego typu — nie należy przenosić tego wymagania na C++23.

Konwersję wykonuje się jawnie przez reinterpret_cast. Odwzorowanie wskaźnika na liczbę jest zdefiniowane przez implementację: nazwa nie oznacza dokładnie 32 lub 64 bitów ani identycznego rozmiaru jak void*. Gwarancji dotyczącej void* nie należy rozszerzać na wskaźniki do funkcji lub składowych.

Zachowanie niezmienionej liczby i odtworzenie wskaźnika nie przedłuża czasu życia obiektu. Modyfikowanie liczby nie jest przenośnym zamiennikiem arytmetyki wskaźników i nie gwarantuje wskaźnika, którego można bezpiecznie użyć. Nie traktuj takiej liczby jako trwałego adresu zapisywanego między uruchomieniami programu.

Przykład przechodzi z void* do std::uintptr_t i z powrotem, gdy lokalny obiekt nadal istnieje. Wypisuje wynik porównania zamiast zależnej od uruchomienia liczby reprezentującej adres. Oczekiwany wynik przy dostępnym typie to true; w przeciwnym razie program wypisuje std::uintptr_t unavailable.

Przykłady

#include <cstdint>
#include <iostream>

int main() {
#if defined(UINTPTR_MAX)
    int value = 42;
    void* original = &value;
    std::uintptr_t bits = reinterpret_cast<std::uintptr_t>(original);
    void* restored = reinterpret_cast<void*>(bits);

    std::cout << std::boolalpha << (restored == original) << '\n';
#else
    std::cout << "std::uintptr_t unavailable\n";
#endif
}

Wynik

true

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

Źródła