delrdsfig(3alc)

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

NAME

6        delrdsfig - deletes a figure
7

SYNOPSIS

9       #include "rdsnnn.h"
10       int delrdsfig( Name )
11            char ∗Name;
12

PARAMETER

14       Name                Name of the figure to delete.
15

DESCRIPTION

17       This function deletes the figure called ´Name´ from the list of figures
18       in memory. All objets (instances and rectangles) contained in this fig‐
19       ure are deleted and freed.
20
21       NOTE : The figure is identified by its name.
22

RETURN VALUE

24       1 => The figure has been deleted.
25
26       0 => The figure doesn't exist.
27

ERRORS

29       none
30

EXAMPLE

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