xenial (3) getloins.3.gz

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