_malloca
在堆疊上配置記憶體。 此函式是的版本_alloca
,具有CRT中安全性功能中所述的安全性增強功能。
語法
void *_malloca(
size_t size
);
參數
size
要從堆疊配置的位元組。
傳回值
例 _malloca
程會傳 void
回已配置空間的指標,該空間適合用於儲存任何類型的物件。 如果 size
為 0,_malloca
會配置零長度項目,並傳回該項目的有效指標。
如果 size
大於 _ALLOCA_S_THRESHOLD
,則會 _malloca
嘗試在堆積上配置 ,並在無法配置空間時傳回 Null 指標。 如果 size
小於或等於 _ALLOCA_S_THRESHOLD
,則會 _malloca
嘗試在堆疊上配置,如果無法配置空間,就會產生堆疊溢位例外狀況。 堆疊溢位例外狀況不是C++例外狀況;這是結構化的例外狀況。 您必須使用結構化例外狀況處理 (SEH) 來攔截此例外狀況,而不是使用 C++例外狀況處理 。
備註
如果要求超過 _ALLOCA_S_THRESHOLD
所指定的特定大小 (以位元組為單位),_malloca
會從程式堆疊或堆積配置 size
個位元組。 _malloca
和 _alloca
之間的差異在於,_alloca
一律會在堆疊上配置,而不論其大小為何。 不同於 _alloca
不需要或允許呼叫 來釋放配置記憶體的 ,free
_malloca
需要使用 _freea
來釋放記憶體。 在偵錯模式中,_malloca
一律會從堆積配置記憶體。
在例外狀況處理常式 (EH) 中明確呼叫 _malloca
有一些限制。 在 x86 類別處理器上執行的 EH 例程會在自己的記憶體框架中運作:它們會在記憶體空間中執行工作,而該工作不是根據封入函式堆棧指標的目前位置。 最常見的實作包括 Windows NT 結構化例外狀況處理 (SEH) 和 C++ catch 子句運算式。 因此,在下列任何情節中明確呼叫 _malloca
,會在傳回至呼叫的 EH 常式期間導致程式失敗:
Windows SEH 例外狀況篩選表示式:
__except
(_malloca ()
)Windows SEH 最終例外狀況處理程序:
__finally
{_malloca ()
}C++ EH catch 子句運算式
不過,您可以直接從 EH 常式或應用程式提供的回呼 (由之前列出的其中一個 EH 情節所叫用) 呼叫 _malloca
。
重要
在 Windows 中,如果在 _malloca
區塊內 try/catch
呼叫 ,您必須在 catch 區塊中呼叫 _resetstkoflw
。
除了上述限制之外,使用 /clr
[Common Language Runtime 編譯] 選項 _malloca
時,無法在區塊中使用 __except
。 如需詳細資訊,請參閱 /clr
限制。
需求
常式 | 必要的標頭 |
---|---|
_malloca |
<malloc.h> |
範例: _malloca
// crt_malloca_simple.c
#include <stdio.h>
#include <malloc.h>
void Fn()
{
char * buf = (char *)_malloca( 100 );
// do something with buf
_freea( buf );
}
int main()
{
Fn();
}
範例: _malloca
例外狀況
// crt_malloca_exception.c
// This program demonstrates the use of
// _malloca and trapping any exceptions
// that may occur.
#include <windows.h>
#include <stdio.h>
#include <malloc.h>
int main()
{
int size;
int numberRead = 0;
int errcode = 0;
void *p = NULL;
void *pMarker = NULL;
while (numberRead == 0)
{
printf_s("Enter the number of bytes to allocate "
"using _malloca: ");
numberRead = scanf_s("%d", &size);
}
// Do not use try/catch for _malloca,
// use __try/__except, since _malloca throws
// Structured Exceptions, not C++ exceptions.
__try
{
if (size > 0)
{
p = _malloca( size );
}
else
{
printf_s("Size must be a positive number.");
}
_freea( p );
}
// Catch any exceptions that may occur.
__except( GetExceptionCode() == STATUS_STACK_OVERFLOW )
{
printf_s("_malloca failed!\n");
// If the stack overflows, use this function to restore.
errcode = _resetstkoflw();
if (errcode)
{
printf("Could not reset the stack!");
_exit(1);
}
};
}
輸入
1000
範例輸出
Enter the number of bytes to allocate using _malloca: 1000