1GETPHFIG(3)             MBK PHYSICAL UTILITY FUNCTIONS             GETPHFIG(3)
2
3
4

NAME

6       getphfig - give back a pointer to a phfig
7

SYNOPSIS

9       #include "mph.h"
10       phfig_list ∗getphfig(figname, mode)
11       char ∗figname;
12       char mode;
13

PARAMETERS

15       figname             Name of the figure to be created mode Demanded mode
16                           for the figure
17

DESCRIPTION

19       getphfig returns a pointer to the figure called figname with  the  war‐
20       ranty that the expected information is present in memory.
21       If  mode is 'A' then the figure has all its lists filled, else the fig‐
22       ure may either be complete or interface only.
23       This function allows to completely mask disk  access  for  applications
24       programs. If the figure is in memory, with the specified mode, then the
25       function returns the appropriate pointer. Else, the function performs a
26       call to the loadphfig(3) and returns a pointer to the loaded figure.
27

RETURN VALUE

29       getphfig returns a pointer to the wanted figure.
30

ERRORS

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

EXAMPLE

37       #include "mph.h"
38       phfig_list ∗na2_y()
39       {
40          /∗ find in memory or load from disk na2_y ∗/
41          return getphfig("na2_y", 'A');
42       }
43

SEE ALSO

45       mbk(1), phfig(3), addphfig(3), delphfig(3), loadphfig(3), savephfig(3),
46       flattenphfig(3), rflattenphfig(3).
47
48
49
50
51
52
53ASIM/LIP6                       October 1, 1997                    GETPHFIG(3)