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

# getloins(3)

retrieve a logical instance

## NAME

getloins - retrieve a logical instance

## SYNOPSYS

```
#include "mlo.h"
loins_list ∗getloins(ptfig, name)
lofig_list ∗ptfig;
char ∗name;
```

## PARAMETERS

- *ptfig*

  Pointer to the figure in which the instance should be seeked

- *name*

  Name of the instance

## DESCRIPTION

**getloins** looks in the list of instances of the logical model pointed to by *ptfig* for a instance identified by its *name*. This instance is unique, since the *name* is the instance identifier.

## RETURN VALUE

**getloins** returns a pointer to the instance that matches the *name*.

## ERRORS

**"∗∗∗ mbk error ∗∗∗ illegal getloins instance** *name* **doesn't exist** **in figure** *ptfig-\>NAME***"**

No instance is called *name* in the figure.

## EXAMPLE

```
#include "mlo.h"
loins_list ∗get_ins_by_name(figname, insname)
char ∗figname, ∗insname;
{
   return getloins(getlofig(figname), insname);
}
```

## SEE ALSO

**mbk**(1), [**lofig**(3)](/lofig/3.md), [**loins**(3)](/loins/3.md), [**addloins**(3)](/addloins/3.md), [**delloins**(3)](/delloins/3.md).