NAME

allocrdswinrec - allocates a structure used to create a list of tables of rectangles.

See the file buster/alliance/alc_origin.1.en.gz.

SYNOPSYS

#include "rwinnn.h"


 rdswinrec_list ∗allocrdswinrec()

PARAMETER

none

DESCRIPTION

The allocrdswinrec function allocates a data structure named "rdswinrec_list" used to contain rectangles. This structure contains a list of tables of rdsrec_list structures (see librwi and librds).

RETURN VALUE

The pointer to the newly allocated structure is returned.

ERRORS

"Rds202: rdsalloc error, can't continue !"

it's impossible to allocate the memory size desired

EXAMPLE



        #include "mutnnn.h"


        #include "rdsnnn.h"


        #include "rwinnn.h"


        #include "rtlnnn.h"


        main()


          {


            rdsrec_list    ∗Rectangle;


            rdswinrec_list ∗WinRec, ∗HeadWinRec;


            mbkenv();


            rdsenv();


            loadrdsparam();


            WinRec = HeadWinRec = allocrdswinrec();


            /∗ Fill the table with rectangles ∗/


            for ( Counter = 0 ; Counter < RWI_MAX_REC ; Counter ++ )


             {


               if ( Rectangle == (rdsrec_list ∗) NULL ) break;


               WinRec->RECTAB[Counter] = Rectangle;


               Rectangle = Rectangle->NEXT;


             }


            if ( Counter == RWI_MAX_REC ) 


             {


               /∗ the table is full : allocation of a new table ∗/


               WinRec->NEXT = allocrdswinrec();


               WinRec = WinRec->NEXT;


             }


            . . . . 


          }