addlocon(3alc)

1ADDLOCON(3)                  MBK LOGICAL FUNCTIONS                 ADDLOCON(3)
2
3
4

NAME

6       addlocon - create a logical connector
7

SYNOPSIS

9       #include "mlo.h"
10       locon_list ∗addlocon(ptfig, name, ptsig, dir)
11       lofig_list ∗ptfig;
12       char ∗name;
13       losig_list ∗ptsig;
14       char dir;
15

PARAMETERS

17       ptfig               Pointer to the figure in which the connector should
18                           be added
19
20       name                Name of the connector
21
22       ptsig               Pointer on the signal linked to the connector
23
24       dir                 Connector direction type
25

DESCRIPTION

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

RETURN VALUE

38       addlocon returns a pointer to the newly created connector.
39

ERRORS

41       "∗∗∗ mbk error ∗∗∗ addlocon impossible : connector name already  exists
42       in figure ptfig->NAME"
43              The  name  being  the logical connector idenfier, two connectors
44              may not have the same name in a given figure.
45       "∗∗∗ mbk error ∗∗∗ addlocon impossible : bad direction  dir  in  figure
46       ptfig->NAME"
47              The  dir  does not have a legal value. For the set of legal val‐
48              ues, see locon(3).
49

EXAMPLE

51       #include "mlo.h"
52       locon_list ∗du_con(ptfig, ptcon) /∗ duplicate connector ∗/
53       lofig_list ∗ptfig;
54       locon_list ∗ptcon;
55       {
56          return addlocon(ptfig, ptcon->NAME, ptcon->SIG, ptcon->DIR);
57       }
58