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

CKTIS / C

realloc — redimensionar uma alocação

`realloc` redimensiona uma alocação dinâmica. Utilize um ponteiro temporário e verifique o resultado antes de substituir o ponteiro existente.

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

Sintaxe

#include <stdlib.h>
void *realloc(void *ptr, size_t size);

realloc, de <stdlib.h>, recebe um tamanho em bytes. Preserva os bytes iniciais até ao menor dos tamanhos, antigo e novo; os bytes acrescentados têm valores não especificados.

Em caso de sucesso, o tempo de vida do objeto antigo termina, mesmo que seja utilizado o mesmo endereço. Utilize o ponteiro devolvido e reconstrua os ponteiros para os elementos. Se falhar para um tamanho positivo, o resultado é NULL e a alocação antiga permanece inalterada. Atribuir o resultado diretamente a p pode, por isso, perder a alocação.

Com NULL, a função comporta-se como malloc. Caso contrário, é necessário o início de uma alocação ainda existente; um tamanho zero implica comportamento indefinido em C23. Utilize free para libertar memória. Se n for variável, verifique n <= SIZE_MAX / sizeof *p antes da multiplicação (<stdint.h>).

O exemplo aumenta o tamanho de um array e inicializa o novo elemento. A opção C23 do repositório não atesta a conformidade do ambiente de execução de produção.

Exemplos

#include <stdio.h>
#include <stdlib.h>

int main(void)
{
    int *p = malloc(2 * sizeof *p);
    if (p == NULL) {
        return EXIT_FAILURE;
    }
    p[0] = 10;
    p[1] = 20;

    int *tmp = realloc(p, 3 * sizeof *p);
    if (tmp == NULL) {
        free(p);
        return EXIT_FAILURE;
    }
    p = tmp;
    p[2] = 30;

    printf("%d %d %d\n", p[0], p[1], p[2]);
    free(p);
    return EXIT_SUCCESS;
}

Resultado

10 20 30

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