_alloca

發行項
02/28/2013

在堆疊上配置記憶體。這個函式已被取代，因為更安全版本使用。 see _malloca.

void *_alloca( 
   size_t size 
);

參數

[in] size
若要從堆疊中配置的位元組數。

傳回值

_alloca例行傳回void配置的空間，一定要適當地對齊來儲存任何型別的物件的指標。如果size為 0， _alloca會配置一個長度為零的項目，並傳回有效的指標到該項目。

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

備註

_alloca配置size程式堆疊中的位元組。 (未配置只是傳遞而超出範圍) 時，呼叫的函式結束時，會自動釋放配置的空間。因此，無法通過所傳回的指標值**_alloca**做為引數以免費。

有限制，以明確地呼叫**_alloca例外狀況處理常式 (EH) 中。在 x 執行的 EH 常式 86 類別處理器在它自己的記憶體框架下運作：它們不建置於封入函式的堆疊指標目前所在位置的記憶體空間中執行工作。最常見的實作包括 Windows NT 結構化例外處理 (SEH) 和 C++ catch 子句運算式。因此，明確地呼叫_alloca**在下列案例中的結果傳回給呼叫的 EH 常式的程式失敗：

Windows NT SEH 例外狀況篩選條件運算式: __except (_alloca () )
Windows NT SEH 最終的例外處理常式： __finally {_alloca () }
C + + EH catch 子句運算式

不過， _alloca可直接從 EH 常式或從應用程式提供的回呼，叫用由呼叫其中一個先前列出的 EH 案例。

安全性提示
在 Windows XP 中，如果_alloca ，會呼叫在 try/catch 區塊中，您必須呼叫 _resetstkoflw catch 區塊中。

除了上述的限制，當使用/clr (通用語言執行階段編譯) 選項， _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 occured 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)
        {
            printf_s("Could not reset the stack!\n");
            _exit(1);
        }
    };
}