CKTIS / C++
std::uintptr_t — celočíselný typ na uchovanie hodnoty ukazovateľa
std::uintptr_t z <cstdint> je celočíselný typ bez znamienka, ktorý umožňuje previesť platný void* na celé číslo a späť bez straty hodnoty ukazovateľa. V C++23 je voliteľný a neurčuje pevnú šírku ani prenositeľný formát adresy.
Verzia: C++23; repository compiler flag, production runtime not attested
Syntax
#include <cstdint>
std::uintptr_t bits = reinterpret_cast<std::uintptr_t>(ptr);
void* restored = reinterpret_cast<void*>(bits);std::uintptr_t z <cstdint> je alias celočíselného typu bez znamienka. Umožňuje previesť platný void* na celé číslo a potom späť na void*, ktorý sa pri porovnaní rovná pôvodnému ukazovateľu. V C++23 je tento typ voliteľný; po vložení hlavičky overte jeho dostupnosť pomocou #if defined(UINTPTR_MAX). Uvedený odkaz smeruje na priebežne sa vyvíjajúci pracovný návrh, ktorý tento typ teraz vyžaduje — túto požiadavku spätne nevzťahujte na C++23.
Prevody vykonávajte výslovne pomocou reinterpret_cast. Mapovanie ukazovateľa na celé číslo je definované implementáciou: názov nezaručuje presne 32 ani 64 bitov ani rovnakú veľkosť ako void*. Záruku pre void* nerozširujte na ukazovatele na funkcie ani na ukazovatele na členov.
Ponechanie celého čísla bez zmeny a obnovenie ukazovateľa nepredlžuje životnosť objektu. Úprava celého čísla nie je prenositeľnou náhradou za aritmetiku ukazovateľov a nezaručuje ukazovateľ, ktorý možno bezpečne použiť. Nepovažujte toto celé číslo za trvalú adresu, ktorú možno ukladať medzi spusteniami programu.
Príklad prevádza void* na std::uintptr_t a späť, kým lokálny objekt stále existuje. Vypisuje výsledok porovnania namiesto celého čísla predstavujúceho adresu, ktoré závisí od konkrétneho spustenia. Ak je typ dostupný, očakávaný výstup je true; inak program vypíše std::uintptr_t unavailable.
Príklady
#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
}
Výsledok
true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.