delrdsins(3alc)

1DELRDSINS(3)                RDS PHYSICAL FUNCTIONS                DELRDSINS(3)
2
3
4

NAME

6        delrdsins - deletes an instance of a figure
7

SYNOPSIS

9       #include "rdsnnn.h"
10       int delrdsins( Figure, Name )
11            rdsfig_list ∗Figure;
12            char        ∗Name;
13

PARAMETER

15       Figure              figure which contains the instance to delete.
16
17       Name                Name  of the instance to delete in the figure 'Fig‐
18                           ure'.
19

DESCRIPTION

21       Deletes an instance and objects contained in it. The instance is  iden‐
22       tified  by  its  name in the figure which contains it. This instance is
23       warrantied to be unique, because its name is an identifier at the given
24       hierarchical  level.
25

RETURN VALUE

27       1 => the instance has been deleted.
28
29       0 => the instance doesn't exist.
30

ERRORS

32       none
33

EXAMPLE

35             #include "mutnnn.h"
36             #include "rdsnnn.h"
37             #include "rtlnnn.h"
38               typedef struct UserStruct
39                {
40                  char ∗STRING;
41                  void ∗USER1;
42                } UserStruct;
43                main()
44                 {
45                   rdsfig_list ∗Figure;
46                   rdsrec_list ∗Rectangle;
47                   rdsins_list ∗Instance;
48                   int          Result;
49                   mbkenv();
50                   rdsenv();
51                   loadrdsparam();
52                   Figure = addrdsfig ("core",sizeof ( UserStruct ) );
53                   Instance  = addrdsins (Figure,"na2_y","and2",RDS_NOSYM,8,6);
54                   Rectangle =
55                    addrdsinsrec(Instance,"Alu1",RDS_ALU1,2,4,12,1);
56                   /∗
57                     destruction of instance and its objects
58                   ∗/
59                   Result = delrdsins ( Figure,"and2" );
60                   if ( Result == 0 ) printf("Instance 'and2' not found !\n");
61                 }
62