INCATALOG(3)						       MBK UTILITY FUNCTIONS						      INCATALOG(3)

NAME

       incatalog - test if cell belongs to the catalog file

ORIGIN

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

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

SYNOPSYS

       #include "mut.h"
       int incatalog(figname)
       char *figname;

PARAMETER

       figname		   Name of the cell to be checked

DESCRIPTION

       incatalog checks a cell represented by its figname beeing present in the catalog file with the 'C' attribut.
       This means that when flattening, the hierachy destruction stops when encountering a cell belonging to the catalog.  This is meant for  both
       logical and physical views, of course.
       The  catalog  is  the sum of all the catalogs of the cells libraries specified in the MBK_CATA_LIB(1) and MBK_WORK_LIB(1).  The catalogs of
       the MBK_CATA_LIB(1) are the files called CATAL, and the MBK_WORK_LIB(1) is by default CATAL but can be changed to MBK_CATAL_NAME(1).

RETURN VALUE

       incatalog returns 0 if the cell does not belong to the catalog with the 'C' attribut, a value different from 0 if it does.

EXAMPLE

       #include "mut.h"
       char *tell_if_incatalog(name)
       char *name;
       {
	  return incatalog(name) ? "Jawohl, mein Herr" : "Nein, danke";
       }

SEE ALSO

       mbk(1), incatalogfeed(3), incatalogdelete(3), incataloggds(3), MBK_CATAL_NAME(1), MBK_CATA_LIB(1), MBK_WORK_LIB(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						      INCATALOG(3)