NAME

       autallocheap - 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;
       }

SEE ALSO

       aut(1), autresizeblock(3), autallocblock(3), autfreeblock(3), autfreeheap(3).