_malloca
Aloca memória na pilha.Esta é uma versão de _alloca com aprimoramentos de segurança conforme descrito em Aprimoramentos de segurança no CRT.
void *_malloca(
size_t size
);
Parâmetros
- size
Bytes a ser alocada da pilha.
Valor de retorno
The _malloca rotina retorna uma void ponteiro para o espaço alocado, tem a garantia de ser alinhadas adequadamente para o armazenamento de qualquer tipo de objeto. If size é 0, _malloca aloca um item de comprimento zero e retorna um ponteiro válido para esse item.
Uma exceção de estouro de pilha é gerada se o espaço não pode ser alocado.A exceção de estouro de pilha não é uma exceção de C++; é uma exceção estruturada.Em vez de usar o tratamento de exceção de C++, você deve usar Manipulação de exceção estruturada (SEH).
Comentários
_malloca aloca size bytes da pilha do programa ou o heap se a solicitação excede um determinado dimensionar em bytes fornecido pelo _ALLOCA_S_THRESHOLD. A diferença entre _malloca e _alloca é o _alloca sempre aloca na pilha, independentemente do dimensionar. Ao contrário de _alloca, que não exigem ou permite uma telefonar para free Para liberar a memória alocada por isso, _malloca requer o uso de _freea Para liberar memória. No modo de depurar, _malloca sempre aloca memória do heap.
Há restrições para chamar explicitamente _malloca em um manipulador de exceção (EH). Rotinas EH executados no x86 - classe processadores operam em seu próprio quadro de memória: Eles executam suas tarefas no espaço de memória que não esteja baseado no local corrente do ponteiro de pilha da função delimitador.Implementações mais comuns incluem o Windows NT estruturada (SEH) de manipulação de exceção e expressões de cláusula catch C++.Portanto, chamar explicitamente _malloca em qualquer um dos seguintes resultados cenários em falha de programa durante o retorno para chamar a rotina EH:
Expressão de filtro de exceção SEH Windows NT: __except (_malloca () )
Manipulador de exceção final de SEH do Windows NT: __finally {_malloca () }
Expressão de cláusula catch C++ EH
No entanto, _malloca pode ser chamado diretamente a partir de uma rotina de EH ou de um retorno de chamada fornecido pelo aplicativo que é invocado por um dos cenários de EH listados anteriormente.
Observação de segurança: |
---|
No Windows XP, se _malloca é chamado dentro de um bloco try/catch, você deve chamar _resetstkoflw no bloco catch. |
Juntamente com as restrições acima, ao usar o CLR (common linguagem tempo de execução Compilation) option, _malloca não pode ser usado em __except blocos. Para obter mais informações, consulte /CLR restrições.
Requisitos
Rotina |
Cabeçalho necessário |
---|---|
_malloca |
<malloc.h> |
Exemplo
// crt_malloca_simple.c
#include <stdio.h>
#include <malloc.h>
void Fn()
{
char * buf = _malloca( 100 );
// do something with buf
_freea( buf );
}
int main()
{
Fn();
}
// 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 Allocated 1000 bytes of stack at 0x0012FAC4
Equivalente do NET Framework
Não aplicável. Para telefonar a função C padrão, use PInvoke. Para obter mais informações, consulte Exemplos de invocação de plataforma.