_heapchk

Artigo
06/09/2015

Executará verificações de consistência no heap.

int _heapchk( void );

Valor de retorno

_heapchk retorna uma das seguintes constantes de manifesto inteiro definidas no Malloc.h.

_HEAPBADBEGIN
Informações de cabeçalho inicial é incorreto ou não pode ser encontrada.
_HEAPBADNODE
O nó incorreto foi localizado ou heap é danificado.
_HEAPBADPTR
O ponteiro no heap não é válido.
_HEAPEMPTY
O heap não foi inicializado.
_HEAPOK
O heap parece ser consistente.

Além disso, se um erro ocorrer, _heapchk define errno como ENOSYS.

Comentários

Os problemas heap- relacionados à depuração de ajuda da função de _heapchk verificando a consistência mínima do heap. Se o sistema operacional não oferecer suporte a _heapchk(por exemplo, Windows 98), a função retorna _HEAPOK e define errno como ENOSYS.

Requisitos

Rotina	Cabeçalho necessário	Cabeçalho opcional
_heapchk	<malloc.h>	<errno.h>

Para obter mais informações sobre compatibilidade, consulte Compatibilidade na Introdução.

Exemplo

// 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;
   }
}