_msize

ヒープで割り当てられたメモリ ブロックのサイズを返します。

構文

size_t _msize(
   void *memblock
);

パラメーター

memblock
メモリ ブロックへのポインター。

戻り値

_msize は符号なし整数としてサイズ (バイト数) を返します。

解説

_msize 関数は、calloc、malloc、または realloc への呼び出しで割り当てられたメモリ ブロックのサイズ (バイト数) を返します。

アプリケーションが C のランタイム ライブラリのデバッグ バージョンにリンクされている場合、_msize は _msize_dbg として解決されます。 デバッグ プロセス中のヒープの管理方法の詳細については、「CRT デバッグ ヒープ」を参照してください。

この関数は、そのパラメーターを検証します。 ポインターのNULL場合memblockは、「_msizeパラメーターの検証」で説明されているように、無効なパラメーター ハンドラーを呼び出します。 エラーが処理されると、errno が EINVAL に設定され、-1 が返されます。

既定では、この関数のグローバル状態の適用対象は、アプリケーションになります。 この動作を変更するには、「CRT のグローバル状態」を参照してください。

必要条件

ルーチンによって返される値	必須ヘッダー
_msize	<malloc.h>

互換性の詳細については、「 Compatibility」を参照してください。

ライブラリ

C ランタイム ライブラリのすべてのバージョン。

例

realloc の例を参照してください。

関連項目

メモリ割り当て
calloc
_expand
malloc
realloc