_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。

重要

如果在 try 块内调用 _alloca，则必须在 catch 块中调用 _resetstkoflw。

除以上限制外，在使用“/clr (公共语言运行时编译)”选项时，不能在 __except 块中使用 _alloca。 有关更多信息，请参阅/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