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).