delrdsfig(3)

NAME

delrdsfig - deletes a figure

SYNOPSYS

#include "rdsnnn.h"
int delrdsfig( Name )
     char ∗Name;

PARAMETER

Name: Name of the figure to delete.

DESCRIPTION

This function deletes the figure called ´Name´ from the list of figures in memory. All objets (instances and rectangles) contained in this figure are deleted and freed.

NOTE : The figure is identified by its name.

RETURN VALUE

1 => The figure has been deleted.

0 => The figure 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  = 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 = delrdsfig ( "core" );
            if ( Result == 0 ) printf("Figure 'core' not found !\n"); 
          }