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

NAME

6       flattenlofig - flatten a instance in a logical figure
7

SYNOPSIS

9       #include "mlo.h"
10       void flattenlofig(ptfig, insname, concat)
11       lofig_list ∗ptfig;
12       char ∗insname;
13       char concat;
14

PARAMETERS

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

DESCRIPTION

23       flattenlofig 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   objects   coming   from   the   instance   are   named
28       insname'X'objectname,   where   'X'   is   the  caracter  set  int  the
29       MBK_SEPAR(1) environment variable, or the value NO, and then the object
30       name  remains  inchanged. This is quite dangerous since name unicity is
31       no  more  warrantied,  and  may  cause  the  flatten   to   fail.   See
32       MBK_SEPAR(1), mbkenv(3) and concatname(3) for details.
33

ERRORS

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

EXAMPLE

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

SEE ALSO

50       mbk(1), mbkenv(3),  lofig(3),  addlofig(3),  getlofig(3),  dellofig(3),
51       loadlofig(3), savelofig(3), rflattenlofig(3), MBK_SEPAR(1).
52
53
54
55
56
57
58ASIM/LIP6                       October 1, 1997                FLATTENLOFIG(3)
Impressum