delrdsfig.3alc - Man Page

deletes a figure

Synopsis

#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"); 
          }

See Also

librds, allocrdsfig

Info

October 1, 1997 ASIM/LIP6 RDS PHYSICAL FUNCTIONS