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

# GENLIB\_GET\_CON\_Y(3)

retrieve the x coordinate of an instance connector

## NAME

GENLIB\_GET\_CON\_Y - retrieve the x coordinate of an instance connector

## SYNOPSYS

```
long GENLIB_GET_CON_Y(insname, conname, index)
char ∗insname, ∗conname;
long index;
```

## PARAMETERS

- *insname*

  Name of the instance in the which the connector is to be searched for

- *conname*

  Name of the connector

- *index*

  Connector index

## DESCRIPTION

**GET\_CON\_Y** looks for  the connector, *conname*, in the instance called *insname*. Then it computes its absolute coordinates in the figure, and gives back the y coordinate.

## RETURN VALUE

The function returns a long int beeing the y position of the connector in the current figure

## ERRORS

**"GENLIB\_GET\_CON\_Y impossible : missing GENLIB\_DEF\_PHFIG"**

No figure has been yet specified by a call to **DEF\_PHFIG**. So it isn't possible to place a connector inside it. you must call **DEF\_PHFIG** before any other layout action.

**"illegal getphins : instance called** *insname* **does not exist"**

No instance called *insname* exists in the current figure.

**"illegal getphcon : connectors** *conname***, index** *index* **does not exist"**

No connector called *conname* exists in the model of the instance *insname*.

## EXAMPLE

```
#include <genlib.h>
main()
{
long x, y;
	/∗ Create a figure to work on  ∗/
	GENLIB_DEF_PHFIG("cell");
	GENLIB_PLACE("gaci0_b", "r1", NOSYM, 23L, 54L);
	/∗ Get a connector ∗/
	y = GENLIB_GET_CON_Y("r1", "a", 1);
	.
	.
	GENLIB_PHVIA(x, y, CONT_VIA);
	/∗ Save that on disk ∗/
	GENLIB_SAVE_PHFIG();
}
```

## SEE ALSO

[**genlib**(1)](/genlib/1.md), [**GENLIB\_DEF\_PHFIG**(3)](/GENLIB_DEF_PHFIG/3.md), [**GENLIB\_SAVE\_PHFIG**(3)](/GENLIB_SAVE_PHFIG/3.md), [**GENLIB\_PHCON**(3)](/GENLIB_PHCON/3.md), [**GENLIB\_PHSEG**(3)](/GENLIB_PHSEG/3.md), [**GENLIB\_COPY\_UP\_CON**(3)](/GENLIB_COPY_UP_CON/3.md), [**GENLIB\_COPY\_UP\_ALL\_CON**(3)](/GENLIB_COPY_UP_ALL_CON/3.md), [**GENLIB\_GET\_CON\_X**(3)](/GENLIB_GET_CON_X/3.md), [**GENLIB\_GET\_REF\_X**(3)](/GENLIB_GET_REF_X/3.md), [**GENLIB\_GET\_REF\_Y**(3)](/GENLIB_GET_REF_Y/3.md).