getphcon(3alc)

1GETPHCON(3)                 MBK PHYSICAL FUNCTIONS                 GETPHCON(3)
2
3
4

NAME

6       getphcon - retrieve a physical connector
7

SYNOPSIS

9       #include "mph.h"
10       phcon_list ∗getphcon(ptfig, conname, index)
11       phfig_list ∗ptfig;
12       char ∗conname;
13       long index;
14

PARAMETERS

16       ptfig               Pointer to the figure in which the connector should
17                           be seeked
18
19       conname             Name of the connector
20
21       index               Connector index
22

DESCRIPTION

24       getphcon looks in the list of connectors of the physical model  pointed
25       to  by  ptfig for a connector identified by its conname and index. Both
26       are needed to make sure the right  connector  is  given  back  since  n
27       internally wired connectors have the same name.
28

RETURN VALUE

30       getphcon returns a pointer to the given connector.
31

ERRORS

33       "∗∗∗  mbk  error  ∗∗∗  illegal getphcon connector conname.index doesn't
34       exist in figure ptfig->NAME"
35              No connectors match both arguments.
36

EXAMPLE

38       #include "mph.h"
39       phcon_list ∗exist(figname, conname)
40       char ∗figname, ∗conname;
41       {
42          /∗ if only one exists, it's this one ∗/
43          return getphcon(getphfig(figname), conname, 0L);
44       }
45