C Language and Libraries Help (clang.hlp) (
Table of Contents;
Topic list)
Important Notice
The pages on this site contain documentation for very old MS-DOS software,
purely for historical purposes.
If you're looking for up-to-date documentation, particularly for programming,
you should not rely on the information found here, as it will be woefully
out of date.
HEAPWALK.C
◄Up► ◄Contents► ◄Index► ◄Back►
─────Run-Time Library───────────────────────────────────────────────────────
/* HEAPWALK.C illustrates heap testing functions including:
* _heapchk _heapset _heapwalk _msize
*/
#include <stdio.h>
#include <conio.h>
#include <malloc.h>
#include <stdlib.h>
#include <time.h>
/* Macro to get a random integer within a specified range */
#define getrandom( min, max ) ((rand() % (int)(((max)+1) - (min))) + (min))
int __far *heapvalidate( unsigned fill ); /* Prototypes */
void heapstat( int status );
void main()
{
unsigned *p[10];
int i, __far *perr;
srand( (unsigned)time( NULL ) ); /* Seed with current time */
/* Check heap status. Should be OK at start of heap. */
heapstat( _heapchk() );
/* Now do some operations that affect the heap. In this example,
* allocate random-size blocks.
*/
for( i = 0; i < 10; i++ )
{
if( (p[i] = (unsigned *)calloc( getrandom( 1, 10000 ),
sizeof( unsigned ) )) == NULL )
{
--i;
break;
}
printf( "Allocated %u at %Fp\n",
_msize( p[i] ), (void __far *)p[i] );
}
/* Fill all free blocks with the test value. */
heapstat( _heapset( 254 ) );
/* In a real program, you might do operations here on the allocated
* buffers. Then do heapvalidate to make sure none of the operations
* wrote to free blocks.
*/
perr = heapvalidate( 254 );
if( perr == NULL )
printf( "Free entries are unchanged.\n\n" );
else
printf( "Free entry at %Fp modified.\n\n", perr );
/* Do some more heap operations. */
for( i = 9; i >= 0; i-- )
{
free( p[i] );
printf( "Deallocating %u at %Fp\n",
_msize( p[i] ), (void __far *)p[i] );
}
/* Check heap again. */
heapstat( _heapchk() );
}
/* Tests each block in the heap. If a modified free block is found,
* returns its address. Otherwise returns NULL.
*/
int __far *heapvalidate( unsigned fill )
{
_HEAPINFO hi;
unsigned heapstatus, i;
unsigned __far *p;
/* Walk through entries, checking free blocks. */
hi._pentry = NULL;
while( (heapstatus = _heapwalk( &hi )) == _HEAPOK )
{
/* For free entries, check each byte to see that it still
* has only the fill value. Return address if changed.
*/
if( hi._useflag != _USEDENTRY )
{
for( p = (unsigned __far *)hi._pentry, i = 0; i < hi._size; p++,i++ )
if( (unsigned)*p != fill )
return hi._pentry;
}
}
return NULL;
}
/* Reports on the status returned by _heapwalk, _heapset, or _heapchk */
void heapstat( int status )
{
printf( "\nHeap status: " );
switch( status )
{
case _HEAPOK:
printf( "OK - heap is fine" );
break;
case _HEAPEMPTY:
printf( "OK - empty heap" );
break;
case _HEAPEND:
printf( "OK - end of heap" );
break;
case _HEAPBADPTR:
printf( "ERROR - bad pointer to heap" );
break;
case _HEAPBADBEGIN:
printf( "ERROR - bad start of heap" );
break;
case _HEAPBADNODE:
printf( "ERROR - bad node in heap" );
break;
}
printf( "\n\n" );
}
-♦-