KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::uintptr_t — een integer-type om een pointerwaarde op te slaan

std::uintptr_t uit <cstdint> is een unsigned integer-type waarmee een geldige void* naar een integer en terug kan worden omgezet zonder de pointerwaarde te verliezen. Het type is optioneel in C++23 en legt geen vaste breedte of portable adresnotatie vast.

Versie: 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 uit <cstdint> is een alias voor een unsigned integer-type. Hiermee kan een geldige void* worden omgezet naar een integer en daarna terug naar een void* die als gelijk aan de oorspronkelijke pointer vergelijkt. In C++23 is dit type optioneel; controleer na het opnemen van de header de beschikbaarheid met #if defined(UINTPTR_MAX). De opgegeven verwijzing leidt naar het evoluerende werkdocument, dat dit type inmiddels vereist — pas die eis niet met terugwerkende kracht toe op C++23.

Voer de conversies expliciet uit met reinterpret_cast. De omzetting van pointer naar integer is implementatiegedefinieerd: de naam belooft niet precies 32 of 64 bits en ook niet dezelfde grootte als void*. Breid de garantie voor void* niet uit naar functiepointers of pointers naar members.

De integer ongewijzigd houden en de pointer reconstrueren verlengt de levensduur van het object niet. De integer wijzigen is geen portable vervanging voor pointer-aritmetiek en garandeert geen pointer die veilig kan worden gebruikt. Behandel deze integer niet als een blijvend adres dat tussen programma-uitvoeringen kan worden opgeslagen.

Het voorbeeld zet void* om naar std::uintptr_t en terug terwijl het lokale object nog bestaat. Het geeft het vergelijkingsresultaat weer in plaats van een integer die het adres voorstelt en per uitvoering kan verschillen. Als het type beschikbaar is, is de verwachte uitvoer true; anders geeft het programma std::uintptr_t unavailable weer.

Voorbeelden

#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
}

Resultaat

true

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen