---
name: "delrdsfig"
section: "3"
platform: "linux"
package: "alliance"
version: "5.1.1-3"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/delrdsfig"
---

# delrdsfig(3)

deletes a figure

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

## SEE ALSO

**librds,** **allocrdsfig**