# OS_AddToHeap

## C Specification

      #include <nitro/os.h>

      void OS_AddToHeap( OSArenaId id, OSHeapHandle heap, void* start, void* end );

## Arguments

id | Arena ID of the arena that is associated with a heap to which a region will be added.
heap | Handle of a heap to which a region will be added.
start | Start address of the region that is to be added.
end | End address (+1) of the region that is to be added.

## Return Values

None.

## Description

This function adds a memory block to a heap region.

This is used to create a non-contiguous heap region, add a region allocated by `OS_AllocFixed()`, or the like. The arena is specified with the arena ID (id). See `OS_InitArena()` for information on this value.

## See Also

`OS_InitArena`, `OS_InitAlloc`, `OS_CreateHeap`, `OS_AllocFixed`

## Revision History

01/06/2004 Initial version.