_alloca

项目
06/09/2015

在堆栈上分配内存。因为更安全版本可用，此函数已弃用；请参阅 _malloca。

void *_alloca( 
   size_t size 
);

参数

[in] size
从堆栈中分配字节。

返回值

_alloca 例程会返回一个 void 指针指向已分配的空间，可以确保对于任何类型的对象存储对齐。如果 size 为 0，_alloca 将分配长度为零的项，并将有效指针返回到该项中。

如果无法分配空间，将引发堆栈溢出异常。堆栈溢出异常不是 C++ 异常，它是个结构化异常。替换使用 C++ 异常处理程序，必须改用结构化异常处理程序（SEH)。

备注

_alloca 从程序堆栈中分配 size 字节。当调用函数退出时 (不是当赋值仅超出范围时)，分配的空间将自动释放。因此，不要将返回的指针值通过 _alloca 作为参数传递到空闲。

在异常处理程序中 (EH) 显式调用**_alloca** 有局限。 on x86 处理器 EH 例程的类运行在自己的内存运行帧：在这些不基于封闭函数的堆栈指针的当前位置的内存空间执行任务。最常见的通用实现包括 Windows NT 结构化异常处理程序 (SEH) 和 C++ 表达式子句。因此，在返回调用的EH例程中，在程序失败任意以下的方案结果中显式调用**_alloca**：

Windows NT 的 SEH 异常过滤表达式：__except (_alloca () )
Windows NT SEH 最终异常处理程序：__finally {}_alloca ()
C++ EH catch 子句表达式

但是，_alloca 能直接从得到由前面列出的EH方案之一调用的应用程序提供的回调。

安全说明
在 Windows XP 中，如果在 try/catch 块内部调用 _alloca，必须在 catch 块中调用 _resetstkoflw。

除了上述限制外，当使用 /clr (公共语言运行时编译) 选项时，_alloca 不能在 __except 块中使用。有关详细信息，请参阅 /clr Restrictions。

要求

例程	必需的标头
_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);
        }
    };
}