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

# delloins(3)

delete a logical instance

## NAME

delloins - delete a logical instance

## SYNOPSYS

```
#include "mlo.h"
int delloins(ptfig, insname)
lofig_list ∗ptfig;
char ∗insname;
```

## PARAMETERS

- *ptfig*

  Pointer to the figure in which the instance should be deleted

- *insname*

  Name of the instance to be deleted.

## DESCRIPTION

**delloins** delete the instance called *insname* in the figure  pointed to by *ptfig*. This instance is warrantied to be unique, because its name is an identifier at the given hierarchical level. The list consistency is maintainded, and the space freed. The instance connectors are also freed, since if the instance disapear, no more connections can occur on it.

## RETURN VALUE

**delloins** returns **1** if the instance has been deleted, **0** if no such instance exists in the list.

## EXAMPLE

```
#include "mlo.h"
char ∗was_existing(ptfig, insname)
lofig_list ∗ptfig;
char ∗insname;
{
   return delloins(ptfig, insname) ? "you just killed it!"
                                 : "wasn't here anyway";
}
```

## SEE ALSO

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