addlofig.3alc man page

addlofig — create a new structural cell model

Synopsis

#include "mlo.h"
lofig_list ∗addlofig(figname)
char ∗figname;

Parameter

figname

Name of the figure to be created

Description

addlofig creates a new figure called figname and adds it to the list of figure in memory. The new figure is added in front of the list, and becomes itself the list head. No check is performed to see if a figure with the figname exists on disk. If it is the case, the preexisting file will be erased while saving.
The fields LOCON, LOINS, LOSIG, BKSIG, LOPAR LOTRS and USER are set to NULL.
The field MODE is set to 'A'.
The field NEXT points to the previous head of list.

Return Value

addlofig returns a pointer to the newly created figure.

Errors

"∗∗∗ mbk error ∗∗∗ illegal addlofig figure figname already exists"

There is already a logical figure called figname in memory, so it's impossible to give this name to a cell to be created.

Example

#include "mlo.h"
lofig_list ∗get_the_fig(name)
char ∗name;
{
lofig_list ∗pt, ∗fill_fig(/∗ lofig_list ∗ ∗/);
	/∗ scan figure list ∗/
	for (pt = HEAD_LOFIG; pt; pt = pt->NEXT)
		if (!strcmp(pt->NAME, figname))
			break;
	return pt ? pt : fill_fig(addlofig(figname));
}

See Also

mbk(1), lofig(3), getlofig(3), dellofig(3), loadlofig(3), savelofig(3), flattenlofig(3), rflattenlofig(3).

Referenced By

dellofig.3alc(3), flattenlofig.3alc(3), getlofig.3alc(3), loadlofig.3alc(3), lofig.3alc(3), rflattenlofig.3alc(3), savelofig.3alc(3), unflattenlofig.3alc(3).

October 1, 1997 ASIM/LIP6 MBK LOGICAL FUNCTIONS