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

# searchrdsfig(3)

searchs by name a figure in the list of figures

## NAME

searchrdsfig - searchs by name a figure in the list of figures

## SYNOPSYS

```
#include "rutnnn.h"
 rdsfig_list ∗searchrdsfig( Name )
   char ∗Name;
```

## PARAMETER

- *Name*

  Name of the figure to search.

## DESCRIPTION

The *searchrdsfig* function searchs a figure by its name in the list of figures in memory.

## RETURN VALUE

Pointer to the figure searched. If the figure is not found then pointer NULL is returned.

## ERRORS

none

## EXAMPLE

```
        #include "mutnnn.h"
        #include "rdsnnn.h"
        #include "rutnnn.h"
        #include "rtlnnn.h"
        main()
         {
           rdsfig_list ∗Figure;
           rdsfig_list ∗ScanFigure;
           mbkenv();
           rdsenv();
           loadrdsparam();
           Figure = addrdsfig("na2",0);
           Figure = addrdsfig("no2",0);
           Figure = addrdsfig("xr2",0);
           Figure = addrdsfig("n03",0);
           ScanFigure = searchrdsfig("xr2");
           viewrdsfig ( ScanFigure );
         }
```

## SEE ALSO

**librtl,** **librds**