_heapset
檢查堆積是否達到基本的一致性，並將可用的項目設定為指定的值。
重要
此函式已過時。 自 Visual Studio 2015 起，此函式即無法在 CRT 中使用。
語法
int _heapset(
unsigned int fill
);
參數
fill
填滿字元。
傳回值
_heapset 會傳回下列在 Malloc.h 中定義的整數資訊清單常數之一。
| 值 | Description |
|---|---|
_HEAPBADBEGIN |
找不到初始標頭資訊或其無效。 |
_HEAPBADNODE |
堆積已損毀或找到故障的節點。 |
_HEAPEMPTY |
堆積未初始化。 |
_HEAPOK |
堆積看似一致。 |
此外若是發生錯誤， _heapset 會將 errno 設為 ENOSYS。
備註
_heapset 函式會顯示可用的記憶體位置，或不慎被覆寫的節點。
_heapset 會檢查堆積是否達到基本的一致性，然後將堆積中可用項目的每個位元組設為 fill 值。 這項已知值會顯示堆積中的哪些記憶體位置包含可用的節點，以及所含資料中有哪些不慎被誤寫而釋放出記憶體。 如果作業系統不支援 _heapset（例如 Windows 98），函式會傳 _HEAPOK 回 並將 設定 errno 為 ENOSYS。
需求
| 常式 | 必要的標頭 | 選擇性標頭 |
|---|---|---|
_heapset |
<malloc.h> | <errno.h> |
如需詳細的相容性資訊，請參閱簡介中的 Compatibility 。
範例
// crt_heapset.c
// This program checks the heap and
// fills in free entries with the character 'Z'.
#include <malloc.h>
#include <stdio.h>
#include <stdlib.h>
int main( void )
{
int heapstatus;
char *buffer;
if( (buffer = malloc( 1 )) == NULL ) // Make sure heap is
exit( 0 ); // initialized
heapstatus = _heapset( 'Z' ); // Fill in free entries
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;
}
free( buffer );
}
OK - heap is fine