allocrdswinrec(3) allocates a structure used to create a list of tables of rectangles.

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