_heapmin

Releases unused heap memory to the operating system.

Syntax

int _heapmin( void );

Return Value

If successful, _heapmin returns 0; otherwise, the function returns -1 and sets errno to ENOSYS.

For more information about this and other return codes, see _doserrno, errno, _sys_errlist, and _sys_nerr.

Remarks

The _heapmin function minimizes the heap by releasing unused heap memory to the operating system. If the operating system does not support _heapmin(for example, Windows 98), the function returns -1 and sets errno to ENOSYS.

Requirements

Routine Required header Optional header
_heapmin <malloc.h> <errno.h>

For more compatibility information, see Compatibility.

See also

Memory Allocation
free
_heapadd
_heapchk
_heapset
_heapwalk
malloc