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

# getlocap(3)

retrieve a logical capacitor

## NAME

getlocap - retrieve a logical capacitor

## SYNOPSYS

```
#include "mlo.h"
locap_list ∗getlocap(ptfig,name)
lofig_list ∗ptfig ;
const char ∗name ;
```

## PARAMETERS

- *ptfig*

  Pointer to the figure in which the capacitor should be seeked

- *name*

  Instance name of the capacitor

## DESCRIPTION

**getlocap** looks in the list of capacitors of the logical model pointed to by *ptfig* for a capacitor identified by its instance *name*.

## RETURN VALUE

**getlocap** returns a pointer to the given capacitor.

## ERRORS

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

No capacitor matches the name.

## EXAMPLE

```
#include "mlo.h"
locap_list ∗exist(char ∗figname,char ∗capname)
{
  return getlocap(getlofig(figname,'A'),capname) ;
}
```

## SEE ALSO

**mbk**(1), [**lofig**(3)](/lofig/3.md), [**locap**(3)](/locap/3.md), [**addlocap**(3)](/addlocap/3.md), [**setlocap**(3)](/setlocap/3.md), [**dellocap**(3)](/dellocap/3.md).