_msize

Retorna o tamanho de um bloco de memória alocado no heap.

Sintaxe

size_t _msize(
   void *memblock
);

Parâmetros

memblock
Ponteiro para o bloco de memória.

Valor retornado

_msize retorna o tamanho (em bytes) como um inteiro sem sinal.

Comentários

A função _msize retorna o tamanho, em bytes, do bloco de memória alocado por uma chamada para calloc, malloc ou realloc.

Quando o aplicativo estiver vinculado a uma versão de depuração das bibliotecas de runtime do C, _msize será resolvido como _msize_dbg. Para obter mais informações sobre como o heap é gerenciado durante o processo de depuração, consulte O heap de depuração do CRT.

Esta função valida seu parâmetro. If memblock é um NULL ponteiro, _msize invoca um manipulador de parâmetro inválido, conforme descrito em Validação de parâmetro. Se o erro for tratado, a função será definida errno como EINVAL e retornará -1 (18.446.744.073.709.551.615 sem sinal).

Por padrão, o estado global dessa função tem como escopo o aplicativo. Para alterar esse comportamento, confira Estado global no CRT.

Requisitos

Rotina Cabeçalho necessário
_msize <malloc.h>

Para obter informações sobre compatibilidade, consulte Compatibilidade.

Bibliotecas

Todas as versões das bibliotecas em tempo de execução C.

Exemplo

Confira o exemplo de realloc.

Confira também

Alocação de memória
calloc
_expand
malloc
realloc