allocrdswinrec

ALLOCRDSWINREC(3)           RDS PHYSICAL FUNCTIONS           ALLOCRDSWINREC(3)



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


ORIGIN
       This software belongs to the  ALLIANCE CAD SYSTEM developed by the ASIM
       team at LIP6 laboratory of Université Pierre et Marie CURIE, in Paris,
       France.

       Web : http://asim.lip6.fr/recherche/alliance/
       E-mail : alliance-users@asim.lip6.fr


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




BUG REPORT
       This tool is under development at the ASIM department of the LIP6
       laboratory.
       We need your feedback to improve documentation and tools.






ASIM/LIP6                       October 1, 1997              ALLOCRDSWINREC(3)