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