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

# delphins(3)

delete a physical instance

## NAME

delphins - delete a physical instance

## SYNOPSYS

```
#include "mph.h"
int delphins(ptfig, insname)
phfig_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

**delphins** 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.

## RETURN VALUE

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

## EXAMPLE

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

## SEE ALSO

**mbk**(1), [**phfig**(3)](/phfig/3.md), [**phins**(3)](/phins/3.md), [**addphins**(3)](/addphins/3.md), [**getphins**(3)](/getphins/3.md).