Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::uintptr_t — un tipo intero per conservare un valore di puntatore

std::uintptr_t di <cstdint> è un tipo intero senza segno che permette di convertire un void* valido in un intero e viceversa senza perdere il valore del puntatore. È opzionale in C++23 e non specifica né una larghezza fissa né un formato di indirizzo portabile.

Versione: C++23; repository compiler flag, production runtime not attested

Sintassi

#include <cstdint>

std::uintptr_t bits = reinterpret_cast<std::uintptr_t>(ptr);
void* restored = reinterpret_cast<void*>(bits);

std::uintptr_t di <cstdint> è un alias di un tipo intero senza segno. Consente di convertire un void* valido in un intero e poi di nuovo in un void* che risulta uguale al puntatore originale nel confronto. In C++23 questo tipo è opzionale; dopo aver incluso l’header, controllane la disponibilità con #if defined(UINTPTR_MAX). Il riferimento fornito rimanda alla bozza di lavoro in evoluzione, che ora richiede questo tipo: non applicare retroattivamente tale requisito a C++23.

Esegui le conversioni in modo esplicito con reinterpret_cast. La corrispondenza tra puntatore e intero è definita dall’implementazione: il nome non garantisce né esattamente 32 o 64 bit, né una dimensione uguale a quella di void*. Non estendere la garanzia per void* ai puntatori a funzione o ai puntatori a membri.

Mantenere invariato l’intero e ricostruire il puntatore non prolunga la durata dell’oggetto. Modificare l’intero non è un sostituto portabile dell’aritmetica dei puntatori e non garantisce un puntatore utilizzabile in sicurezza. Non considerare questo intero un indirizzo persistente da salvare tra diverse esecuzioni del programma.

L’esempio converte da void* a std::uintptr_t e viceversa mentre l’oggetto locale esiste ancora. Stampa il risultato del confronto invece di un intero che rappresenta l’indirizzo e dipende dall’esecuzione. Se il tipo è disponibile, l’output previsto è true; altrimenti il programma stampa std::uintptr_t unavailable.

Esempi

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

Risultato

true

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti