.\"   $Id: delrdsfig.3,v 1.1 2002/03/13 13:37:37 fred Exp $
.\" @(#)delrdsfig.1 1.11 93/08/18 ; Labo masi cao-vlsi
.if t \{\
.XS \n%
.ti 0.2i
delrdsfig
.XE
.XS0 \n%
.ti 0.2i
delrdsfig
.XE0 \}
.TH DELRDSFIG 3 "October 1, 1997" "ASIM/LIP6" "RDS PHYSICAL FUNCTIONS"
.SH NAME
 delrdsfig \- deletes a figure
.so jessie/alliance/alc_origin.1.en.gz
.SH SYNOPSYS
.nf
.if n \{\
.ft B \}
.if t \{\
.ft CR \}
#include "rdsnnn.h"
int delrdsfig( Name )
     char \(**Name;
.ft R
.fi
.SH PARAMETER
.TP 20
\fIName\fP
Name of the figure to delete.
.SH DESCRIPTION
This function deletes the figure called \'\fIName\fP\' from the list of figures in memory. All objets (instances and rectangles) contained in this figure are deleted and freed. 
.TP
\fINOTE\fP : The figure is identified by its name.
.SH RETURN VALUE
1 => The figure has been deleted.
.TP
0 => The figure doesn't exist.
.SH ERRORS
none
.SH EXAMPLE
.ta 3n 6n 9n 12n 15n 18n 21n
.nf
.if n \{\
.ft B \}
.if t \{\
.ft CR \}
      #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  = delrdsfig (Figure,"na2_y","and2",RDS_NOSYM,8,6); 
            Rectangle =
             addrdsfigrec(RdsFigure,"Alu1",RDS_ALU1,2,4,12,1);
            /\(**
              destruction of the figure , its instance, its rectangle 
            \(**/
            Result = \fBdelrdsfig\fP ( "core" );
            if ( Result == 0 ) printf("Figure 'core' not found !\\n"); 
          }
.ft R
.fi
.SH SEE ALSO
.BR librds,
.BR allocrdsfig


.so jessie/alliance/alc_bug_report.1.en.gz