man autallocheap (3): heap memory allocator

SYNOPSYS

#include "aut101.h"
char *autallocheap( Size )
   unsigned int Size;

PARAMETERS

Size: Number of memory bytes to be contiguously allocated

DESCRIPTION

autallocheap returns a block of Size bytes length, allocated on the heap. The memory block is set to zero. Its use is strongly encouraged when the Size is very small.

RETURN VALUE

autallocheap returns a pointer to a Size bytes long block.

ERRORS

"autalloc: alloc error, can't continue !"

: System break can't be moved anymore, no more memory can be retrieved from the system.

EXAMPLE

#include "aut101.h"
typedef struct bipointer
{
  struct bipointer *NEXT;
  void             *DATA; 
} bipointer;
bipointer *addbipointer( Data );
  void *Data;
{
  bipointer *Bp = (bipointer *)autallocheap( sizeof( bipointer ) );
  Bp->DATA = Data; return Bp;
}