Provided by: alliance_5.0-20110203-4_amd64 bug

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