NAME

       flattenlofig - flatten a instance in a logical figure

SYNOPSYS

       #include "mlo.h"
       void flattenlofig(ptfig, insname, concat)
       lofig_list ∗ptfig;
       char ∗insname;
       char concat;

PARAMETERS

       ptfig               Pointer to a logical figure

       insname             Name of the instance to be flattened

       concat              Name generation mode

DESCRIPTION

       flattenlofig  flattens  the  instance  called insname in the figure pointed to by ptfig. Flattening means
       incorporating the contents of the instance in the figure and removing it from its instance list.
       the concat argument can take either the value YES in which case the name of the objects comming from  the
       instance  are  named insname'X'objectname, where 'X' is the caracter set int the MBK_SEPAR(1) environment
       variable, or the value NO, and then the object name remains inchanged. This is quite dangerous since name
       unicity is no more warrantied, and may cause  the  flatten  to  fail.  See  MBK_SEPAR(1),  mbkenv(3)  and
       concatname(3) for details.

ERRORS

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

EXAMPLE

       #include "mlo.h"
       void flatten_na2_y_s(ptfig)
       lofig_list ∗ptfig;
       {
       loins_list ∗pt;
          for (pt = ptfig->LOINS; pt; pt = pt->NEXT) /∗ scan instance list ∗/
             if (!strcmp(pt->FIGNAME, "na2_y"))
                flattenlofig(ptfig, pt->INSNAME, NO);
       }

SEE ALSO

       mbk(1),   mbkenv(3),   lofig(3),   addlofig(3),  getlofig(3),  dellofig(3),  loadlofig(3),  savelofig(3),
       rflattenlofig(3), MBK_SEPAR(1).

ASIM/LIP6                                        October 1, 1997                                 FLATTENLOFIG(3)