Share via

_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

另請參閱

記憶體配置
calloc
malloc
realloc
_resetstkoflw