# OS_GetTotalOccupiedSize

## 構文

      #include <nitro/os.h>

      u32 OS_GetTotalOccupiedSize( OSArenaId id, OSHeapHandle heap );

## 引数

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

## 返り値

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

## 説明

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

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

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

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

## 参照

`OS_InitAlloc, OS_GetTotalFreeSize, OS_GetMaxFreeSize
OS_GetTotalAllocSize
`

## 履歴

2005/10/07 初版