flattenlofig

FLATTENLOFIG(3)          MBK LOGICAL UTILITY FUNCTIONS         FLATTENLOFIG(3)



NAME
       flattenlofig - flatten a instance in a logical figure


ORIGIN
       This software belongs to the  ALLIANCE CAD SYSTEM developed by the ASIM
       team at LIP6 laboratory of Université Pierre et Marie CURIE, in Paris,
       France.

       Web : http://asim.lip6.fr/recherche/alliance/
       E-mail : alliance-users@asim.lip6.fr


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).




BUG REPORT
       This tool is under development at the ASIM department of the LIP6
       laboratory.
       We need your feedback to improve documentation and tools.






ASIM/LIP6                       October 1, 1997                FLATTENLOFIG(3)