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), phins(3), addphins(3), getphins(3).