_alloca

在堆疊上配置記憶體。 此函式已被取代，因為有更安全的版本可供使用;請參閱 _malloca 。

語法

void *_alloca(
   size_t size
);

參數

size
要從堆疊配置的位元組。

傳回值

例 _alloca 程會傳 void 回已配置空間的指標，該空間適合用於儲存任何類型的物件。 如果 size 為 0，_alloca 會配置零長度項目，並傳回該項目的有效指標。

如果無法配置空間，就會產生堆疊溢位例外狀況。 堆疊溢位例外狀況不是 C++ 例外狀況;這是結構化的例外狀況。 您必須使用結構化例外狀況處理 （SEH） ，而不是使用 C++ 例外狀況處理 。

備註

_allocasize從程式堆疊配置位元組。 當呼叫函式結束時，系統會自動釋放已配置的空間（而不是配置只會超過範圍時）。 因此，請勿將 所 _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

另請參閱

記憶體配置
calloc
malloc
realloc
_resetstkoflw
_malloca