Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes