addphfig(3alc)

1ADDPHFIG(3)                 MBK PHYSICAL FUNCTIONS                 ADDPHFIG(3)
2
3
4

NAME

6       addphfig - create a new physical cell model
7

SYNOPSIS

9       #include "mph.h"
10       phfig_list ∗addphfig(figname)
11       char ∗figname;
12

PARAMETER

14       figname             Name of the figure to be created
15

DESCRIPTION

17       addphfig creates a new figure called figname and adds it to the list of
18       figure in memory. The new figure is added in front  of  the  list,  and
19       becomes  itself the list head. No check is performed to see if a figure
20       with the figname exists on disk. If it is  the  case,  the  preexisting
21       file will be erased while saving.
22       The fields PHCON, PHINS, PHSEG, PHVIA, PHREF and USER are set to NULL.
23       The fields XAB1,  YAB1,  XAB2,  XAB2 are set to 0L.
24       The field MODE is set to 'A'.
25       The field NEXT points to the previous head of list.
26

RETURN VALUE

28       addphfig returns a pointer to the newly created figure.
29

ERRORS

31       "∗∗∗ mbk error ∗∗∗ illegal addphfig figure figname already exists"
32              There  is  already  a  figure  called figname in memory, so it's
33              impossible to give this name to a cell to be created.
34

EXAMPLE

36       #include "mph.h"
37       phfig_list ∗get_the_fig(name)
38       char ∗name;
39       {
40       phfig_list ∗pt, ∗fill_fig(/∗ phfig_list ∗ ∗/);
41          /∗ scan figure list ∗/
42          for (pt = HEAD_PHFIG; pt; pt = pt->NEXT)
43             if (!strcmp(pt->NAME, figname))
44                break;
45          return pt ? pt : fill_fig(addphfig(figname));
46       }
47