malloc
Aloca blocos de memória.
void *malloc(
size_t size
);
Parâmetros
- size
Bytes para alocar.
Valor de retorno
malloc Retorna um ponteiro nulo para o espaço alocado ou NULL Se não houver memória suficiente disponível. Para retornar um ponteiro para um tipo diferente de void, use um tipo convertido no valor retornado. O espaço de armazenamento apontado pelo valor retornado é garantido a ser alinhado adequadamente para o armazenamento de qualquer tipo de objeto.Se dimensionar for 0, malloc aloca um item de comprimento zero no heap e retorna um ponteiro válido para esse item. Sempre verifique o retorno do malloc, mesmo se a quantidade de memória solicitada for pequena.
Comentários
The malloc função aloca um bloco de memória de pelo menos size bytes. O bloco pode ser maior que size bytes por causa de espaço necessário para obter informações sobre alinhamento e manutenção.
In Visual C++ 2005, malloc Define errno para ENOMEM Se falhar uma alocação de memória ou se exceder a quantidade de memória solicitada _HEAP_MAXREQ. Para obter informações sobre esse e outros códigos de erro, consulte errno, _doserrno, _sys_errlist e _sys_nerr.
O código de inicialização usa malloc alocar armazenamento para o _environ, envp, e argv variáveis. As seguintes funções e suas contrapartes de caractere largo também telefonar malloc:
|
|||
|
The C++ _set_new_mode função define o modo de manipulador de novo para malloc. O novo modo de manipulador indica se, no caso de falha, malloc é telefonar a rotina manipuladora de novo sistema autônomo definido pelo _set_new_handler.Por padrão, malloc não telefonar a rotina manipuladora de novo no caso de falha ao alocar memória. Você pode substituir esse comportamento padrão para que, quando malloc Falha ao alocar memória, malloc chama a rotina de manipulador de novo na mesma forma que o new operador não quando ele falhar pelo mesmo motivo. Para substituir o padrão, ligue para
_set_new_mode(1)
no início do seu programa ou o vínculo com NEWMODE.OBJ (consulte Opções de link).
Quando o aplicativo está vinculado com uma versão de depurar das bibliotecas de time de execução C, malloc resolve para _malloc_dbg.Para obter mais informações sobre como a pilha é gerenciada durante o processo de depurar, consulte A Heap depurar CRT.
malloc está marcado como __declspec(noalias) e __declspec(restrict), que significa que a função tem a garantia não modificar variáveis global e que o ponteiro retornado não é com alias. Para obter mais informações, consulte noalias and restringir.
Requisitos
Rotina |
Cabeçalho necessário |
|---|---|
malloc |
<stdlib.h> e <malloc.h> |
Para obter informações adicionais compatibilidade, consulte Compatibilidade na introdução.
Bibliotecas
Todas as versões do C em time de execução bibliotecas.
Exemplo
// crt_malloc.c
// This program allocates memory with
// malloc, then frees the memory with free.
#include <stdlib.h> // For _MAX_PATH definition
#include <stdio.h>
#include <malloc.h>
int main( void )
{
char *string;
// Allocate space for a path name
string = malloc( _MAX_PATH );
// In a C++ file, explicitly cast malloc's return. For example,
// string = (char *)malloc( _MAX_PATH );
if( string == NULL )
printf( "Insufficient memory available\n" );
else
{
printf( "Memory space allocated for path name\n" );
free( string );
printf( "Memory freed\n" );
}
}
Memory space allocated for path name Memory freed
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.