_msize

傳回堆積中所配置的記憶體區塊大小。

語法

size_t _msize(
   void *memblock
);

參數

memblock
記憶體區塊的指標。

傳回值

_msize 傳回不帶正負號的整數大小 (以位元組為單位)。

備註

_msize 函式會傳回由 calloc、malloc 或 realloc 呼叫所配置的記憶體區塊大小 (以位元組為單位)。

當應用程式與 C 執行時間連結庫的偵錯版本連結時, _msize 會解析為 _msize_dbg。 如需如何在偵錯程式期間管理堆積的詳細資訊,請參閱 CRT偵錯堆積。

這個函式會驗證其參數。 如果 memblock 為NULL指標,_msize請叫用無效的參數處理程式,如參數驗證中所述。 如果處理錯誤,函式會將 設定 errno 為 EINVAL ,並傳回 -1 (18,446,744,073,709,551,615 unsigned)。

根據預設,此函式的全域狀態會限定於應用程式。 若要變更此行為,請參閱 CRT 中的全域狀態。

需求

常式 必要的標頭
_msize <malloc.h>

如需相容性詳細資訊,請參閱相容性。

程式庫

所有版本的 C 執行階段程式庫。

範例

請參閱 realloc 的範例。

另請參閱

記憶體配置
calloc
_expand
malloc
realloc