Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

allocrdswinrec(3) [debian man page]

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)

Check Out this Related Man Page

FREERDSREC(3)						      RDS PHYSICAL FUNCTIONS						     FREERDSREC(3)

NAME

	freerdsrec - free memory associated to a rectangle

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 "rdsnnn.h"
	 void freerdsrec( Rectangle, Size )
	   rdsrec_list	*Rectangle;
	   unsigned int  Size;

PARAMETER

       Rectangle	   Pointer of the rectangle structure to free.

       Size		   Size of the structure added (if it exists) to rdsrec_list structure.

DESCRIPTION

       This function deletes the memory associated to the rectangle. Memory used is both memory of rdsrec_list structure and memory of the  struc-
       ture  added  by the user. If the user structure doesn't exist, the parameter 'Size' must be to 0L. Memory place used by the Pointers of the
       rdsrec_list structure (and the added structure) is not deleted so the user has to free these pointers before calling the freerdsrec() func-
       tion.

RETURN VALUE

       nothing

ERRORS

       none

EXAMPLE

		  #include "mutnnn.h"
		  #include "rdsnnn.h"
		  #include "rtlnnn.h"
	      typedef struct UserStruct
	       {
		 char *STRING;
		 void *USER1;
	       } UserStruct;
	      main()
	       {
		 rdsrec_list *Rectangle;
		      mbkenv();
		      rdsenv();
		      loadrdsparam();
		 Rectangle = allocrdsrec ( sizeof ( UserStruct ) );
		 ...
		 /* */ freerdsrec ( Rectangle, sizeof ( UserStruct ) );
	       }

SEE ALSO

       librds, freerdsrec, rdsfree

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						     FREERDSREC(3)
Man Page