Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje