Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C++

std::uintptr_t — un tipo entero para almacenar un valor de puntero

std::uintptr_t de <cstdint> es un tipo entero sin signo que permite convertir un void* válido en un entero y de vuelta sin perder el valor del puntero. Es opcional en C++23 y no especifica ni un ancho fijo ni un formato de dirección portable.

Versión: C++23; repository compiler flag, production runtime not attested

Sintaxis

#include <cstdint>

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

std::uintptr_t, de <cstdint>, es un alias de un tipo entero sin signo. Permite convertir un void* válido en un entero y después volver a un void* que se compara como igual al puntero original. En C++23 este tipo es opcional; comprueba su disponibilidad con #if defined(UINTPTR_MAX) después de incluir la cabecera. La referencia proporcionada lleva al borrador de trabajo en evolución, que ahora exige este tipo; no apliques ese requisito retroactivamente a C++23.

Realiza las conversiones explícitamente con reinterpret_cast. La correspondencia entre punteros y enteros está definida por la implementación: el nombre no garantiza exactamente 32 o 64 bits ni el mismo tamaño que void*. No extiendas la garantía para void* a los punteros a funciones ni a los punteros a miembros.

Mantener el entero sin cambios y reconstruir el puntero no prolonga la duración del objeto. Modificar el entero no es un sustituto portable de la aritmética de punteros ni garantiza un puntero que pueda usarse de forma segura. No trates este entero como una dirección persistente que se pueda guardar entre ejecuciones del programa.

El ejemplo convierte de void* a std::uintptr_t y de vuelta mientras el objeto local aún existe. Imprime el resultado de la comparación en lugar de un entero que represente la dirección y dependa de la ejecución. Si el tipo está disponible, la salida esperada es true; de lo contrario, el programa imprime std::uintptr_t unavailable.

Ejemplos

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

Resultado

true

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes