getlofig

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 Université 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 figure.

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)