getlofig(3) [opendarwin man page]

GETLOFIG(3)						   MBK LOGICAL UTILITY FUNCTIONS					       GETLOFIG(3)

NAME

       getlofig - give back a pointer to a lofig

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"
       lofig_list *getlofig(figname, mode)
       char *figname;
       char mode;

PARAMETERS

       figname		   Name of the figure to be created

       mode		   Demanded mode for the figure

DESCRIPTION

       getlofig returns a pointer to the figure called figname with the warranty that the expected information is present in memory.
       If mode is 'A' then the figure has all its lists filled, else the figure may either be complete or interface only.
       This function allows to completly mask disk access for applications programs. If the figure is in memory, with the specified mode, then the
       function  returns  the appropriate pointer. Else, the function performs a call to the loadlofig(3) and returns a pointer to the loaded fig-
       ure.

RETURN VALUE

       getlofig returns a pointer to the wanted figure.

ERRORS

       getlofig cannot give any errors, but the subsequent calls it performs to parsers do. So the source of trouble may be the call to  getlofig.
       See loadlofig(3) for details.

EXAMPLE

       #include "mlo.h"
       lofig_list *na2_y()
       {
	  /* find in memory or load from disk na2_y */
	  return getlofig("na2_y", 'A');
       }

SEE ALSO

       mbk(1), lofig(3), addlofig(3), dellofig(3), loadlofig(3), savelofig(3), flattenlofig(3), rflattenlofig(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						       GETLOFIG(3)

ADDLOFIG(3)						       MBK LOGICAL FUNCTIONS						       ADDLOFIG(3)

NAME

       addlofig - create a new structural cell model

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"
       lofig_list *addlofig(figname)
       char *figname;

PARAMETER

       figname		   Name of the figure to be created

DESCRIPTION

       addlofig creates a new figure called figname and adds it to the list of figure in memory. The new figure is added in front of the list, and
       becomes	itself the list head. No check is performed to see if a figure with the figname exists on disk. If it is the case, the preexisting
       file will be erased while saving.
       The fields LOCON, LOINS, LOSIG, BKSIG, LOPAR LOTRS and USER are set to NULL.
       The field MODE is set to 'A'.
       The field NEXT points to the previous head of list.

RETURN VALUE

       addlofig returns a pointer to the newly created figure.

ERRORS

       "*** mbk error *** illegal addlofig figure figname already exists"
	      There is already a logical figure called figname in memory, so it's impossible to give this name to a cell to be created.

EXAMPLE

       #include "mlo.h"
       lofig_list *get_the_fig(name)
       char *name;
       {
       lofig_list *pt, *fill_fig(/* lofig_list * */);
	  /* scan figure list */
	  for (pt = HEAD_LOFIG; pt; pt = pt->NEXT)
	     if (!strcmp(pt->NAME, figname))
		break;
	  return pt ? pt : fill_fig(addlofig(figname));
       }

SEE ALSO

       mbk(1), lofig(3), getlofig(3), dellofig(3), loadlofig(3), savelofig(3), flattenlofig(3), rflattenlofig(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						       ADDLOFIG(3)