_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
.