# OS_AddToHeap

## C Specification

      #include <nitro/os.h>

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

## Description

This function adds a memory block to a heap region to create a non-contiguous heap region, add a region allocated by `OS_AllocFixed`, or the like. The arena is specified by an arena ID, `id`. See `OS_InitArena` for information on this value.

## 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.

## See Also

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

## Revision History

01/06/2004 Initial version