DELRDSINS(3)						      RDS PHYSICAL FUNCTIONS						      DELRDSINS(3)

NAME

	delrdsins - deletes an instance of a figure

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"
       int delrdsins( Figure, Name )
	    rdsfig_list *Figure;
	    char	*Name;

PARAMETER

       Figure		   figure which contains the instance to delete.

       Name		   Name of the instance to delete in the figure 'Figure'.

DESCRIPTION

       Deletes an instance and objects contained in it. The instance is identified by its name in the figure which contains it. This  instance	is
       warrantied to be unique, because its name is an identifier at the given hierarchical  level.

RETURN VALUE

       1 => the instance has been deleted.

       0 => the instance doesn't exist.

ERRORS

       none

EXAMPLE

	     #include "mutnnn.h"
	     #include "rdsnnn.h"
	     #include "rtlnnn.h"
	       typedef struct UserStruct
		{
		  char *STRING;
		  void *USER1;
		} UserStruct;
		main()
		 {
		   rdsfig_list *Figure;
		   rdsrec_list *Rectangle;
		   rdsins_list *Instance;
		   int		Result;
		   mbkenv();
		   rdsenv();
		   loadrdsparam();
		   Figure = addrdsfig ("core",sizeof ( UserStruct ) );
		   Instance  = addrdsins (Figure,"na2_y","and2",RDS_NOSYM,8,6);
		   Rectangle =
		    addrdsinsrec(Instance,"Alu1",RDS_ALU1,2,4,12,1);
		   /*
		     destruction of instance and its objects
		   */
		   Result = delrdsins ( Figure,"and2" );
		   if ( Result == 0 ) printf("Instance 'and2' not found !
");
		 }

SEE ALSO

       librds, allocrdsins

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						      DELRDSINS(3)