_heapchk

项目
06/09/2015

在堆上进行一致性检查。

int _heapchk( void );

返回值

_heapchk 返回在 Malloc.h 定义的以下整数清单常数之一。

_HEAPBADBEGIN
初始的头信息是错误的的或未能找到。
_HEAPBADNODE
错误节点已找到或堆已经损坏。
_HEAPBADPTR
在堆中指针是无效的。
_HEAPEMPTY
堆尚未初始化。
_HEAPOK
堆应该是一致的。

此外，如果发生错误，_heapchk 设置 errno 到 ENOSYS。

备注

_heapchk 函数可通过检查堆最小的一致性帮助调试堆相关的问题。如果操作系统不支持 _heapchk(例如，Windows 98)，则该函数返回 _HEAPOK 并设置errno 为 ENOSYS。

要求

例程	必需的标头	可选标头
_heapchk	<malloc.h>	<errno.h>

有关更多兼容性信息，请参见“简介”中的兼容性。

示例

// crt_heapchk.c
// This program checks the heap for
// consistency and prints an appropriate message.
 
#include <malloc.h>
#include <stdio.h>

int main( void )
{
   int  heapstatus;
   char *buffer;

   // Allocate and deallocate some memory
   if( (buffer = (char *)malloc( 100 )) != NULL )
      free( buffer );

   // Check heap status
   heapstatus = _heapchk();
   switch( heapstatus )
   {
   case _HEAPOK:
      printf(" OK - heap is fine\n" );
      break;
   case _HEAPEMPTY:
      printf(" OK - heap is empty\n" );
      break;
   case _HEAPBADBEGIN:
      printf( "ERROR - bad start of heap\n" );
      break;
   case _HEAPBADNODE:
      printf( "ERROR - bad node in heap\n" );
      break;
   }
}