NAME

       getloins - retrieve a logical instance

SYNOPSYS

       #include "mlo.h"
       loins_list ∗getloins(ptfig, name)
       lofig_list ∗ptfig;
       char ∗name;

PARAMETERS

       ptfig               Pointer to the figure in which the instance should be seeked

       name                Name of the instance

DESCRIPTION

       getloins  looks  in  the  list of instances of the logical model pointed to by ptfig for a
       instance identified by its name. This instance is unique, since the name is  the  instance
       identifier.

RETURN VALUE

       getloins returns a pointer to the instance that matches the name.

ERRORS

       "∗∗∗ mbk error ∗∗∗ illegal getloins instance name doesn't exist in figure ptfig->NAME"
              No instance is called name in the figure.

EXAMPLE

       #include "mlo.h"
       loins_list ∗get_ins_by_name(figname, insname)
       char ∗figname, ∗insname;
       {
          return getloins(getlofig(figname), insname);
       }

SEE ALSO

       mbk(1), lofig(3), loins(3), addloins(3), delloins(3).