flattenphfig.3alc man page

flattenphfig
flattenphfig

flatenphfig — flatten a instance in a figure

Synopsis

#include "mph.h"
void flatenphfig(ptfig, insname, concat)
phfig_list ∗ptfig;
char ∗insname;
char concat;

Parameters

ptfig

Pointer to a physical figure

insname

Name of the instance to be flattened

concat

Name generation mode

Description

flatenphfig 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 object coming 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 flatenphfig, but since it uses many other mbk functions, it may be an error starting point.

Example

#include "mph.h"
void flatten_na2_y_s(ptfig)
phfig_list ∗ptfig;
{
phins_list ∗pt;
	for (pt = ptfig->PHINS; pt; pt = pt->NEXT) /∗ scan instance list ∗/
		if (!strcmp(pt->FIGNAME, "na2_y"))
			flatenphfig(ptfig, pt->INSNAME, NO);
}

See Also

mbk(1), mbkenv(3), phfig(3), addphfig(3), getphfig(3), delphfig(3), loadphfig(3), savephfig(3), rflatenphfig(3), MBK_SEPAR(1).

Referenced By

addphfig.3alc(3), delphfig.3alc(3), getphfig.3alc(3), loadphfig.3alc(3), rflattenphfig.3alc(3), savephfig.3alc(3).

October 1, 1997 ASIM/LIP6 MBK PHYSICAL UTILITY FUNCTIONS