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

# getphref(3)

retrieve a physical reference

## NAME

getphref - retrieve a physical reference

## SYNOPSYS

```
#include "mph.h"
phref_list ∗getphref(ptfig, refname)
phfig_list ∗ptfig;
char ∗refname;
```

## PARAMETERS

- *ptfig*

  Pointer to the figure in which the reference should be seeked

- *refname*

  Name of the reference

## DESCRIPTION

**getphref** looks in the list of references of the physical model pointed to by *ptfig* for a reference identified by its *refname*.

## RETURN VALUE

**getphref** returns a pointer to the reference that matches the *refname*.

## ERROR

**"∗∗∗ mbk error ∗∗∗ illegal getphref reference** *refname* **doesn't exist** **in figure** *ptfig-\>NAME***"**

No reference is called *refname* in the figure.

## EXAMPLE

```
#include "mph.h"
phref_list ∗exist(figname, refname)
char ∗figname, ∗refname;
{
   return getphref(getphfig(figname), refname);
}
```

## SEE ALSO

**mbk**(1), [**phfig**(3)](/phfig/3.md), [**phref**(3)](/phref/3.md), [**addphref**(3)](/addphref/3.md), [**delphref**(3)](/delphref/3.md).