delphins(3)
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";
}