debian man page for 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 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)