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.