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

# viewrdsins(3)

Displays caracteristics of an instance

## NAME

viewrdsins - Displays caracteristics of an instance

## SYNOPSYS

```
 #include "rdsnnn.h"
   void viewrdsins( Instance )
    rdsins_list ∗Instance;
```

## PARAMETERS

- *Instance*

  Instance to display.

## DESCRIPTION

The *viewrdsins* function displays caracteristics of the instance pointed by ´Instance´ and its items.

- instance's parameters displayed :

  - *INSNAME*

    name of the instance.

  - *FIGNAME*

    model's name of the instance.

  - *X,Y*

    position of the lower left corner of the instance.

  - *TRANSF*

    transformation applied to the instance.

  - *SIZE*

    size of the user structure added to the rdsrec\_list structure.

  This function displays also rectangles of the instance (see viewrdsrec() function).

## RETURN VALUE

nothing

## 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;
            mbkenv();
            rdsenv();
            loadrdsparam();
            Figure = addrdsfig ("core",sizeof ( UserStruct ) );
            Instance  = addrdsins (Figure,"na2_y","and2",RDS_NOSYM,8,6);
            Rectangle =
             addrdsinsrec(Instance,"Alu1",RDS_ALU1,2,4,12,1);
            /∗
              visualization of the instance and its rectangle
            ∗/
            /∗ ∗/ viewrdsins ( Instance );
          }
```

## SEE ALSO

**librds,** **viewrdsfig,** **viewrdsrec**