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

# getlocon(3)

retrieve a logical connector

## NAME

getlocon - retrieve a logical connector

## SYNOPSYS

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

## PARAMETERS

- *ptfig*

  Pointer to the figure in which the connector should be seeked

- *name*

  Name of the connector

## DESCRIPTION

**getlocon** looks in the list of connectors of the logical model pointed to by *ptfig* for a connector identified by its *name*, since it should be unique at a given hierachical level.

## RETURN VALUE

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

## ERRORS

**"∗∗∗ mbk error ∗∗∗ getlocon impossible :** **connector** *name* **doesn't exist in figure** *ptfig-\>NAME***"**

No connector matches the name.

## EXAMPLE

```
#include "mlo.h"
locon_list ∗exist(figname, conname)
char ∗figname, ∗conname;
{
   return getlocon(getlofig(figname), conname);
}
```

## SEE ALSO

**mbk**(1), [**lofig**(3)](/lofig/3.md), [**locon**(3)](/locon/3.md), [**addlocon**(3)](/addlocon/3.md), [**dellocon**(3)](/dellocon/3.md).