Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

realloc — zmiana rozmiaru alokacji

`realloc` zmienia rozmiar dynamicznej alokacji. Użyj wskaźnika tymczasowego i sprawdź wynik przed zastąpieniem dotychczasowego wskaźnika.

Wersja: C23; repository compiler flag, production runtime not attested

Składnia

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

realloc z <stdlib.h> przyjmuje rozmiar w bajtach. Zachowuje początkowe bajty do mniejszego z rozmiarów: starego i nowego; dodane bajty mają nieokreślone wartości.

Sukces kończy czas życia starego obiektu, nawet przy tym samym adresie. Używaj zwróconego wskaźnika; odtwórz wskaźniki do elementów. Przy niepowodzeniu dla dodatniego rozmiaru wynik to NULL, a stara alokacja pozostaje niezmieniona. Przypisanie wyniku bezpośrednio do p może więc zgubić alokację.

Dla NULL funkcja działa jak malloc. W przeciwnym razie wymagany jest początek nadal istniejącej alokacji, a zerowy rozmiar oznacza w C23 niezdefiniowane zachowanie. Do zwalniania używaj free. Dla zmiennego n sprawdź przed mnożeniem, czy n <= SIZE_MAX / sizeof *p (<stdint.h>).

Przykład powiększa tablicę i inicjalizuje nowy element. Flaga C23 w repozytorium nie potwierdza zgodności produkcyjnego środowiska wykonawczego.

Przykłady

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

Wynik

10 20 30

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła