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

NAME

6       flatenphfig - flatten a instance in a figure
7

SYNOPSIS

9       #include "mph.h"
10       void flatenphfig(ptfig, insname, concat)
11       phfig_list ∗ptfig;
12       char ∗insname;
13       char concat;
14

PARAMETERS

16       ptfig               Pointer to a physical figure
17
18       insname             Name of the instance to be flattened
19
20       concat              Name generation mode
21

DESCRIPTION

23       flatenphfig  flattens the instance called insname in the figure pointed
24       to by  ptfig.  Flattening  means  incorporating  the  contents  of  the
25       instance in the figure and removing it from its instance list.
26       the  concat  argument  can  take either the value YES in which case the
27       name of the object coming from the instance are named insname'X'object‐
28       name,  where  'X'  is the caracter set int the MBK_SEPAR(1) environment
29       variable, or the value NO, and then the object name remains  inchanged.
30       This  is  quite dangerous since name unicity is no more warrantied, and
31       may cause the flatten to fail. See MBK_SEPAR(1), mbkenv(3) and  concat‐
32       name(3) for details.
33

ERRORS

35       No  errors can directly result from a call to flatenphfig, but since it
36       uses many other mbk functions, it may be an error starting point.
37

EXAMPLE

39       #include "mph.h"
40       void flatten_na2_y_s(ptfig)
41       phfig_list ∗ptfig;
42       {
43       phins_list ∗pt;
44          for (pt = ptfig->PHINS; pt; pt = pt->NEXT) /∗ scan instance list ∗/
45             if (!strcmp(pt->FIGNAME, "na2_y"))
46                flatenphfig(ptfig, pt->INSNAME, NO);
47       }
48

SEE ALSO

50       mbk(1), mbkenv(3),  phfig(3),  addphfig(3),  getphfig(3),  delphfig(3),
51       loadphfig(3), savephfig(3), rflatenphfig(3), MBK_SEPAR(1).
52
53
54
55
56
57
58ASIM/LIP6                       October 1, 1997                FLATTENPHFIG(3)