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

CKTIS / C

uintptr_t — um tipo inteiro para guardar um ponteiro

uintptr_t é um tipo sem sinal opcional de <stdint.h> que permite converter void * num inteiro e voltar a convertê-lo num ponteiro.

Versão: C23; repository compiler flag, production runtime not attested

Sintaxe

#include <stdint.h>
/* If UINTPTR_MAX is defined: */
uintptr_t value = (uintptr_t)(void *)&object;
void *restored = (void *)value;

uintptr_t é um tipo inteiro sem sinal opcional de <stdint.h>, diferente de um tipo inteiro de precisão de bits. Converter um void * válido em uintptr_t e novamente num ponteiro produz um ponteiro que se compara como igual ao original (§7.22.1.4).

Verifique a disponibilidade com #ifdef UINTPTR_MAX, não com #ifdef uintptr_t: um nome typedef não é uma macro. Não parta do princípio de que existe uma largura específica, suporte para ponteiros para funções ou preservação desta garantia após alterações aritméticas ao inteiro.

O exemplo mantém o valor inteiro inalterado e compara os ponteiros, em vez de apresentar um endereço que depende da execução.

Exemplos

#include <stdint.h>
#include <stdio.h>

int main(void)
{
#ifdef UINTPTR_MAX
    int object = 42;
    void *original = &object;
    uintptr_t saved = (uintptr_t)original;
    void *restored = (void *)saved;
    printf("equal: %d\n", restored == original);
#else
    puts("uintptr_t unavailable");
#endif
    return 0;
}

Resultado

equal: 1

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