autallocheap

AUTALLOCHEAP(3)                  AUT FUNCTIONS                 AUTALLOCHEAP(3)



NAME
       autallocheap - heap memory allocator


ORIGIN
       This software belongs to the  ALLIANCE CAD SYSTEM developed by the ASIM
       team at LIP6 laboratory of Université Pierre et Marie CURIE, in Paris,
       France.

       Web : http://asim.lip6.fr/recherche/alliance/
       E-mail : alliance-users@asim.lip6.fr


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




BUG REPORT
       This tool is under development at the ASIM department of the LIP6
       laboratory.
       We need your feedback to improve documentation and tools.






ASIM/LIP6                       October 1, 1997                AUTALLOCHEAP(3)