free(3) - NetBSD Manual Pages

FREE(3)                   NetBSD Programmer's Manual                   FREE(3)


NAME

     free - free up memory allocated with malloc, calloc or realloc


LIBRARY

     Standard C Library (libc, -lc)


SYNOPSIS

     #include <stdlib.h>

     void
     free(void *ptr);


DESCRIPTION

     The free() function causes the space pointed to by ptr to be deallocated,
     that is, made available for further allocation.  If ptr is a null point-
     er, no action occurs.  Otherwise, if the argument does not match a point-
     er earlier returned by the calloc() malloc() or realloc() function, or if
     the space has been deallocated by a call to free() or realloc(), general
     havoc may occur.


RETURN VALUES

     The free() function returns no value.


SEE ALSO

     calloc(3), malloc(3), realloc(3)


STANDARDS

     The free() function conforms to ANSI X3.159-1989 (``ANSI C'').

NetBSD 1.4                       June 4, 1993                                1