opendarwin man page for getloins

GETLOINS(3)						       MBK LOGICAL FUNCTIONS						       GETLOINS(3)

NAME
       getloins - retrieve a logical instance

ORIGIN
       This  software  belongs	to  the  ALLIANCE CAD SYSTEM developed by the ASIM team at LIP6 laboratory of Universite Pierre et Marie CURIE, in
       Paris, France.

       Web : http://asim.lip6.fr/recherche/alliance/
       E-mail : alliance-users@asim.lip6.fr

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

BUG REPORT
       This tool is under development at the ASIM department of the LIP6 laboratory.
       We need your feedback to improve documentation and tools.

ASIM
/LIP6							  October 1, 1997						       GETLOINS(3)