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

# getphcon(3)

retrieve a physical connector

## NAME

getphcon - retrieve a physical connector

## SYNOPSYS

```
#include "mph.h"
phcon_list ∗getphcon(ptfig, conname, index)
phfig_list ∗ptfig;
char ∗conname;
long index;
```

## PARAMETERS

- *ptfig*

  Pointer to the figure in which the connector should be seeked

- *conname*

  Name of the connector

- *index*

  Connector index

## DESCRIPTION

**getphcon** looks in the list of connectors of the physical model pointed to by *ptfig* for a connector identified by its *conname* and *index*. Both are needed to make sure the right connector is given back since *n* internally wired connectors have the same name.

## RETURN VALUE

**getphcon** returns a pointer to the given connector.

## ERRORS

**"∗∗∗ mbk error ∗∗∗ illegal getphcon connector** *conname.index*  **doesn't exist in figure** *ptfig-\>NAME***"**

No connectors match both arguments.

## EXAMPLE

```
#include "mph.h"
phcon_list ∗exist(figname, conname)
char ∗figname, ∗conname;
{
   /∗ if only one exists, it's this one ∗/
   return getphcon(getphfig(figname), conname, 0L);
}
```

## SEE ALSO

**mbk**(1), [**phfig**(3)](/phfig/3.md), [**phcon**(3)](/phcon/3.md), [**addphcon**(3)](/addphcon/3.md), [**delphcon**(3)](/delphcon/3.md).