NAME

       getphfig - give back a pointer to a phfig

SYNOPSYS

       #include "mph.h"
       phfig_list ∗getphfig(figname, mode)
       char ∗figname;
       char mode;

PARAMETERS

       figname             Name of the figure to be created mode Demanded mode for the figure

DESCRIPTION

       getphfig  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 loadphfig(3) and returns a pointer to the loaded figure.

RETURN VALUE

       getphfig returns a pointer to the wanted figure.

ERRORS

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

EXAMPLE

       #include "mph.h"
       phfig_list ∗na2_y()
       {
          /∗ find in memory or load from disk na2_y ∗/
          return getphfig("na2_y", 'A');
       }

SEE ALSO

       mbk(1),   phfig(3),    addphfig(3),    delphfig(3),    loadphfig(3),    savephfig(3),    flattenphfig(3),
       rflattenphfig(3).