ヒープで割り当てられたメモリ ブロックのサイズを返します。
構文
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> |
互換性の詳細については、「 Compatibility」を参照してください。
ライブラリ
C ランタイム ライブラリのすべてのバージョン。
例
realloc の例を参照してください。