_alloca
在堆疊上配置記憶體。 此函式已被取代,因為有更安全的版本可供使用;請參閱 _malloca
。
語法
void *_alloca(
size_t size
);
參數
size
要從堆疊配置的位元組。
傳回值
例 _alloca
程會傳 void
回已配置空間的指標,該空間適合用於儲存任何類型的物件。 如果 size
為 0,_alloca
會配置零長度項目,並傳回該項目的有效指標。
如果無法配置空間,就會產生堆疊溢位例外狀況。 堆疊溢位例外狀況不是C++例外狀況;這是結構化的例外狀況。 您必須使用 結構化例外狀況處理(SEH),而不是使用C++例外狀況處理 。
備註
_alloca
size
從程式堆疊配置位元組。 當呼叫函式結束時,系統會自動釋放已配置的空間(而不是配置只會超過範圍時)。 因此,請勿將 所 _alloca
傳回的指標值當做自變數傳遞至 free
。
在例外狀況處理常式 (EH) 中明確呼叫 _alloca
有一些限制。 在 x86 類別處理器上執行的 EH 例程會在自己的記憶體框架中運作:它們會在記憶體空間中執行工作,而該工作不是根據封入函式堆棧指標的目前位置。 最常見的實作包括 Windows 結構化例外狀況處理 (SEH) 和 C++ catch 子句表達式。 因此,在下列任何情節中明確呼叫 _alloca
,會在傳回至呼叫的 EH 常式期間導致程式失敗:
Windows SEH 例外狀況篩選表達式:
__except ( _alloca() )
Windows SEH 最終例外狀況處理程式:
__finally { _alloca() }
C++ EH catch 子句運算式
不過,您可以直接從 EH 常式或應用程式提供的回呼 (由之前列出的其中一個 EH 情節所叫用) 呼叫 _alloca
。
重要
如果在 _alloca
try 區塊內呼叫 ,您必須在 catch 區塊中呼叫 _resetstkoflw
。
除了上述限制之外,使用/clr
[Common Language Runtime 編譯] 選項 _alloca
時,無法在區塊中使用 __except
。 如需詳細資訊,請參閱 /clr
限制。
需求
常式 | 必要的標頭 |
---|---|
_alloca |
<malloc.h> |
範例
// crt_alloca.c
// This program demonstrates the use of
// _alloca and trapping any exceptions
// that may occur.
#include <windows.h>
#include <stdio.h>
#include <malloc.h>
int main()
{
int size = 1000;
int errcode = 0;
void *pData = NULL;
// Note: Do not use try/catch for _alloca,
// use __try/__except, since _alloca throws
// Structured Exceptions, not C++ exceptions.
__try {
// An unbounded _alloca can easily result in a
// stack overflow.
// Checking for a size < 1024 bytes is recommended.
if (size > 0 && size < 1024)
{
pData = _alloca( size );
printf_s( "Allocated %d bytes of stack at 0x%p",
size, pData);
}
else
{
printf_s("Tried to allocate too many bytes.\n");
}
}
// If an exception occurred with the _alloca function
__except( GetExceptionCode() == STATUS_STACK_OVERFLOW )
{
printf_s("_alloca failed!\n");
// If the stack overflows, use this function to restore.
errcode = _resetstkoflw();
if (errcode == 0) // _resetstkoflw() returns 0 on failure
{
printf_s("Could not reset the stack!\n");
_exit(1);
}
};
}
Allocated 1000 bytes of stack at 0x0012FB50