_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