NAME

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

SEE ALSO

       librwi