1GETLOFIG(3)              MBK LOGICAL UTILITY FUNCTIONS             GETLOFIG(3)
2
3
4

NAME

6       getlofig - give back a pointer to a lofig
7

SYNOPSIS

9       #include "mlo.h"
10       lofig_list ∗getlofig(figname, mode)
11       char ∗figname;
12       char mode;
13

PARAMETERS

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

DESCRIPTION

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

RETURN VALUE

30       getlofig returns a pointer to the wanted figure.
31

ERRORS

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

EXAMPLE

38       #include "mlo.h"
39       lofig_list ∗na2_y()
40       {
41          /∗ find in memory or load from disk na2_y ∗/
42          return getlofig("na2_y", 'A');
43       }
44

SEE ALSO

46       mbk(1), lofig(3), addlofig(3), dellofig(3), loadlofig(3), savelofig(3),
47       flattenlofig(3), rflattenlofig(3).
48
49
50
51
52
53
54ASIM/LIP6                       October 1, 1997                    GETLOFIG(3)