# OS_GetTotalAllocSize

## 構文

      #include <nitro/os.h>

      u32 OS_GetTotalAllocSize( OSArenaId id, OSHeapHandle heap );

## 引数

id | 合計サイズを取得するヒープが含まれるアリーナのアリーナID
heap | 合計サイズを取得するヒープのヒープハンドル

## 返り値

ヒープに割り当てられたメモリブロックの合計サイズ(バイト)です。ヘッダは含みません。

## 説明

ヒープに割り当てられたメモリブロックの合計サイズを取得します。

heap に OS_CURRENT_HEAP_HANDLE を指定すると、カレントヒープを指定したことになります。

メモリブロックのヘッダはサイズに含めません。データ領域のサイズの合計となります。ヘッダを含める場合は、`OS_GetTotalOccupiedSize()` を使用してください。

すべての割り当てられたブロックを辿って計算を行なうので、所要時間はメモリブロックの量に比例します。

## 参照

`OS_InitAlloc, OS_GetTotalFreeSize, OS_GetMaxFreeSize
OS_GetTotalOccupiedSize
`

## 履歴

2005/10/07 `OS_GetTotalAllocSize` と `OS_GetTotalOccupiedSize` に分割
2004/11/05 初版