getlofig.3alc man page

getlofig — give back a pointer to a lofig

Synopsis

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

Referenced By

addlofig.3alc(3), dellofig.3alc(3), flattenlofig.3alc(3), guessextdir.3alc(3), loadlofig.3alc(3), lofig.3alc(3), lofigchain.3alc(3), restorealldir.3alc(3), restoredirvbe.3alc(3), rflattenlofig.3alc(3), savelofig.3alc(3), unflattenlofig.3alc(3).

October 1, 1997 ASIM/LIP6 MBK LOGICAL UTILITY FUNCTIONS