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), loins(3), addloins(3), getloins(3).