_alloca
Aloca memória na pilha. Essa função foi preterida pois uma versão mais segura está disponível; confira _malloca
.
Sintaxe
void *_alloca(
size_t size
);
Parâmetros
size
Bytes a serem alocados da pilha.
Valor retornado
A _alloca
rotina retorna um void
ponteiro para o espaço alocado, que está adequadamente alinhado para armazenamento de qualquer tipo de objeto. Se size
for 0, o _alloca
alocará um item de comprimento zero e retornará um ponteiro válido para esse item.
Uma exceção de excedente de pilha será gerada se não for possível alocar o espaço. A exceção de excedente de pilha não é uma exceção do C++; ela é uma exceção estruturada. Em vez de usar o tratamento de exceções C++, você deve usar o SEH (tratamento estruturado de exceções).
Comentários
_alloca
aloca size
bytes da pilha de programas. O espaço alocado é liberado automaticamente quando a função de chamada é encerrada (não quando a alocação simplesmente sai do escopo). Portanto, não passe o valor do ponteiro retornado por _alloca
como um argumento para free
.
Há restrições para chamar _alloca
explicitamente em um EH (manipulador de exceção). As rotinas do EH que são executadas em processadores da classe x86 operam em seu próprio quadro de memória: elas realizam as tarefas no espaço de memória que não é baseado no local atual do ponteiro de pilha da função delimitadora. As implementações mais comuns incluem o SEH (tratamento de exceção estruturado) do Windows e expressões de cláusula catch do C++. Portanto, chamar _alloca
explicitamente em qualquer um dos seguintes cenários resulta em falha do programa durante o retorno ao chamar a rotina EH:
Expressão de filtro de exceção do SEH do Windows:
__except ( _alloca() )
Manipulador de exceção final do SEH do Windows:
__finally { _alloca() }
Expressão da cláusula catch do EH de C++
No entanto, _alloca
pode ser chamado diretamente de dentro de uma rotina do EH ou de um retorno de chamada fornecido pelo aplicativo, que é invocado por um dos cenários do EH listados anteriormente.
Importante
Se _alloca
for chamado dentro de um bloco try, você deverá chamar _resetstkoflw
o bloco catch.
Além das restrições acima, ao usar a opção /clr
(Compilação do Common Language Runtime), o _alloca
não poderá ser usado nos blocos __except
. Para obter mais informações, consulte /clr
Restrições.
Requisitos
Rotina | Cabeçalho necessário |
---|---|
_alloca |
<malloc.h> |
Exemplo
// 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
Confira também
Alocação de memória
calloc
malloc
realloc
_resetstkoflw
_malloca