incatalog.3alc man page

incatalog
incatalog

incatalog — test if cell belongs to the catalog file

Synopsis

#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 being present in the catalog file with the 'C' attribut.
This means that when flattening, the hierarchy 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).

Referenced By

catal.5alc(5), incatalogdelete.3alc(3), incatalogfeed.3alc(3), incataloggds.3alc(3), rflattenlofig.3alc(3), rflattenphfig.3alc(3).

October 1, 1997 ASIM/LIP6 MBK UTILITY FUNCTIONS