Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje