allocrdswinrec.3alc man page

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

Synopsis

#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

Info

October 1, 1997 ASIM/LIP6 RDS PHYSICAL FUNCTIONS