CKTIS / C++
std::uintptr_t — celočíselný typ pro uložení hodnoty ukazatele
std::uintptr_t z <cstdint> je celočíselný typ bez znaménka, který umožňuje převést platný void* na celé číslo a zpět bez ztráty hodnoty ukazatele. V C++23 je volitelný a neurčuje pevnou šířku ani přenositelný formát adresy.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
#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 znaménka. Umožňuje převést platný void* na celé číslo a poté zpět na void*, který se při porovnání rovná původnímu ukazateli. V C++23 je tento typ volitelný; jeho dostupnost po vložení hlavičky ověřte pomocí #if defined(UINTPTR_MAX). Uvedený odkaz vede na průběžně se vyvíjející pracovní návrh, který tento typ nyní vyžaduje — tento požadavek zpětně nevztahujte na C++23.
Převody provádějte výslovně pomocí reinterpret_cast. Mapování ukazatele na celé číslo je definováno implementací: název nezaručuje přesně 32 ani 64 bitů ani stejnou velikost jako void*. Záruku pro void* nerozšiřujte na ukazatele na funkce ani na ukazatele na členy.
Ponechání celého čísla beze změny a obnovení ukazatele neprodlužuje dobu života objektu. Úprava celého čísla není přenositelnou náhradou za aritmetiku ukazatelů a nezaručuje ukazatel, který lze bezpečně použít. Nepovažujte toto celé číslo za trvalou adresu, kterou lze ukládat mezi spuštěními programu.
Příklad převádí void* na std::uintptr_t a zpět, dokud lokální objekt stále existuje. Vypisuje výsledek porovnání namísto celého čísla představujícího adresu, které závisí na konkrétním spuštění. Je-li typ dostupný, očekávaný výstup je true; jinak program vypíše std::uintptr_t unavailable.
Pří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ýsledek
true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.