free

malloc() , calloc() , aligned_alloc() , (C11 이후) 또는 realloc() 에 의해 이전에 할당된 공간을 해제합니다.

만약 ptr 가 널 포인터인 경우, 이 함수는 아무 작업도 수행하지 않습니다.

ptr 의 값이 이전에 malloc() , calloc() , realloc() , 또는 aligned_alloc() (C11부터) 에 의해 반환된 값과 같지 않으면 동작은 정의되지 않습니다.

ptr 이 참조하는 메모리 영역이 이미 해제된 경우, 즉 free() , free_sized() , free_aligned_sized() (since C23) , 또는 realloc() 가 이미 ptr 을 인수로 호출되었고, 이후 malloc() , calloc() , realloc() , 또는 aligned_alloc() (since C11) 호출이 ptr 과 동일한 포인터를 반환하지 않은 경우, 이 동작은 정의되지 않습니다.

free() 가 반환된 후 ptr 포인터를 통해 접근이 발생하면(다른 할당 함수가 우연히 ptr 과 동일한 포인터 값을 반환한 경우를 제외하고) 이 동작은 정의되지 않습니다.

매개변수

반환값

(없음)

참고 사항

이 함수는 특수 케이스의 양을 줄이기 위해 널 포인터를 받아들이고(아무 작업도 수행하지 않음) 아무 작업도 수행하지 않습니다. 할당이 성공하든 실패하든, 할당 함수가 반환하는 포인터는 free() 에 전달될 수 있습니다.

예제

#include <stdlib.h>
int main(void)
{
    int *p1 = malloc(10*sizeof *p1);
    free(p1); // 모든 할당된 포인터는 해제되어야 함
    int *p2 = calloc(10, sizeof *p2);
    int *p3 = realloc(p2, 1000*sizeof *p3);
    if(p3) // p3가 null이 아니면 realloc에 의해 p2가 해제됨
       free(p3);
    else // p3가 null이면 p2가 해제되지 않음
       free(p2);
}

참고문헌

참고 항목