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 Universite 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)