Compartilhar via


disponível

Desaloca ou libera um bloco de memória.

void free( 
   void *memblock 
);

Parâmetros

  • memblock
    Anteriormente alocado bloco de memória para ser liberado.

Comentários

The free função Desaloca um (bloco de memóriamemblock) que foi alocado anteriormente por uma telefonar para calloc, malloc, ou realloc. O número de bytes liberadas é equivalente ao número de bytes solicitada quando o bloco foi alocado (ou realocado em caso de realloc). If memblock é NULL, o ponteiro será ignorado e free retorna imediatamente. Tentando disponível um ponteiro inválido (um ponteiro para um bloco de memória que não foi alocado pelo calloc, malloc, ou realloc) podem afetam as solicitações subseqüentes de alocação e causar erros.

In Visual C++ 2005, se ocorrer um erro em liberar a memória errno é definida com informações do sistema operacional sobre a natureza da falha. For more information, see errno, _doserrno, _sys_errlist e _sys_nerr.

Depois que um bloco de memória foi liberado, _heapmin minimiza a quantidade de memória disponível no heap concentração as regiões não utilizadas e liberando-os para o sistema operacional.Memória liberada não é liberada para o sistema operacional é restaurada para o pool livre e está disponível para alocação novamente.

Quando o aplicativo está vinculado com uma versão de depurar das bibliotecas de time de execução C, free resolve para _free_dbg.Para obter mais informações sobre como a pilha é gerenciada durante o processo de depurar, consulte A Heap depurar CRT.

free está marcado como __declspec(noalias), que significa que a função é garantida não para modificar as variáveis global. Para obter mais informações, consulte noalias.

Para liberar memória alocada com _malloca, use _freea.

Requisitos

Função

Cabeçalho necessário

free

<stdlib.h> e <malloc.h>

Para obter informações adicionais compatibilidade, consulte Compatibilidade na introdução.

Exemplo

Consulte o exemplo para malloc.

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.

Consulte também

Referência

Alocação de memória

_alloca

calloc

malloc

realocar

_free_dbg

_heapmin

_freea