This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

cfree()

Free allocated memory

Synopsis:

#include <malloc.h>

int cfree( void *ptr );

Arguments:

ptr

A pointer to the block of memory that you want to free. It's safe to call cfree() with a NULL pointer.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The cfree() function deallocates the memory block specified by ptr, which was previously returned by a call to calloc(), malloc() or realloc().

Returns:

1

Classification:

Unix

Caveats:

Calling cfree() on a pointer already deallocated by a call to cfree(), free(), or realloc() could corrupt the memory allocator's data structures.

See also:

alloca(), calloc(), free(), malloc(), realloc(), sbrk()