addlocon.3alc man page

addlocon — create a logical connector

Synopsis

#include "mlo.h"
locon_list ∗addlocon(ptfig, name, ptsig, dir)
lofig_list ∗ptfig;
char ∗name;
losig_list ∗ptsig;
char dir;

Parameters

ptfig

Pointer to the figure in which the connector should be added

name

Name of the connector

ptsig

Pointer on the signal linked to the connector

dir

Connector direction type

Description

addlocon creates a new figure connector called name and adds it to the list of connectors pointed to by ptfig->LOCON. The new connector is added in front of the list, and becomes itself the list head.
The parameters name, ptsig, dir,  width fill respectivly the NAME, SIG and DIR fields of the locon structure. The name should be unique at a given  hierarchical level since it's the connector identifier.
The field TYPE is set to EXTERNAL since a cell connector is being created. The instance connectors are builded up by the addloins(3) call. See addloins(3) for details. For a list of valid dir, see locon(3).

Return Value

addlocon returns a pointer to the newly created connector.

Errors

"∗∗∗ mbk error ∗∗∗ addlocon impossible :  connector name already exists in figure ptfig->NAME"

The name being the logical connector idenfier, two connectors may not have the same name in a given figure.

"∗∗∗ mbk error ∗∗∗ addlocon impossible : bad direction dir in figure ptfig->NAME"

The dir does not have a legal value. For the set of legal values, see locon(3).

Example

#include "mlo.h"
locon_list ∗du_con(ptfig, ptcon) /∗ duplicate connector ∗/
lofig_list ∗ptfig;
locon_list ∗ptcon;
{
   return addlocon(ptfig, ptcon->NAME, ptcon->SIG, ptcon->DIR);
}

See Also

mbk(1), locon(3), loins(3), lofig(3), getlocon(3), dellocon(3), phcon(3).

Referenced By

checkloconorder.3alc(3), dellocon.3alc(3), getlocon.3alc(3), locon.3alc(3), sortlocon.3alc(3), unflattenlofig.3alc(3).

October 1, 1997 ASIM/LIP6 MBK LOGICAL FUNCTIONS