alloc(3)                                                 alloc(3)



NNAAMMEE
       alloc - allocate memory

SSYYNNTTAAXX
       ##iinncclluuddee <<aalllloocc..hh>>

       char *aalllloocc(_n_e_w);

       void aalllloocc__ffrreeee(_x);

       void aalllloocc__rree(&_x,_o_l_d,_n_e_w);

       char *_x;
       unsigned int _o_l_d;
       unsigned int _n_e_w;

DDEESSCCRRIIPPTTIIOONN
       aalllloocc  allocates  enough space from the heap for _n_e_w bytes
       of data, adequately aligned for any data type.  _n_e_w may be
       0.  aalllloocc returns a pointer to the space.  If space is not
       available, aalllloocc returns 0, setting eerrrrnnoo appropriately.

       aalllloocc__ffrreeee returns space to the heap.

       aalllloocc__rree expands the space allocated to _x from  _o_l_d  bytes
       to  _n_e_w  bytes.   It allocates new space, copies _o_l_d bytes
       from the old space to the new space, returns the old space
       to  the heap, and changes _x to point to the new space.  It
       then returns 1.   If  space  is  not  available,  aalllloocc__rree
       returns 0, leaving the old space alone.

SSEEEE AALLSSOO
       sbrk(2), malloc(3), error(3)



                                                         alloc(3)