NAME

       getlofig - give back a pointer to a lofig

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