CKTIS / C++
std::uintptr_t — um tipo inteiro para guardar um valor de ponteiro
std::uintptr_t de <cstdint> é um tipo inteiro sem sinal que permite converter um void* válido num inteiro e novamente sem perder o valor do ponteiro. É opcional em C++23 e não especifica uma largura fixa nem um formato de endereço portátil.
Versão: C++23; repository compiler flag, production runtime not attested
Sintaxe
#include <cstdint>
std::uintptr_t bits = reinterpret_cast<std::uintptr_t>(ptr);
void* restored = reinterpret_cast<void*>(bits);std::uintptr_t de <cstdint> é um alias de um tipo inteiro sem sinal. Permite converter um void* válido num inteiro e, em seguida, novamente num void* que se compara como igual ao ponteiro original. Em C++23, este tipo é opcional; verifique a sua disponibilidade com #if defined(UINTPTR_MAX) depois de incluir o cabeçalho. A referência indicada remete para o projeto de norma em evolução, que agora exige este tipo — não aplique esse requisito retroativamente a C++23.
Faça as conversões explicitamente com reinterpret_cast. O mapeamento de ponteiros para inteiros é definido pela implementação: o nome não garante exatamente 32 ou 64 bits, nem o mesmo tamanho que void*. Não estenda a garantia relativa a void* aos ponteiros para funções ou aos ponteiros para membros.
Manter o inteiro inalterado e reconstruir o ponteiro não prolonga o tempo de vida do objeto. Modificar o inteiro não é uma alternativa portátil à aritmética de ponteiros e não garante um ponteiro que possa ser utilizado em segurança. Não trate este inteiro como um endereço persistente para guardar entre execuções do programa.
O exemplo converte de void* para std::uintptr_t e novamente enquanto o objeto local ainda existe. Apresenta o resultado da comparação em vez de um inteiro que represente o endereço e dependa da execução. Se o tipo estiver disponível, o resultado esperado é true; caso contrário, o programa apresenta std::uintptr_t unavailable.
Exemplos
#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
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.