NAME

        delrdsins - deletes an instance of a figure

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 !\n");
                 }

SEE ALSO

       librds, allocrdsins

ASIM/LIP6                                        October 1, 1997                                    DELRDSINS(3)