NAME

       getphcon - retrieve a physical connector

SYNOPSYS

       #include "mph.h"
       phcon_list ∗getphcon(ptfig, conname, index)
       phfig_list ∗ptfig;
       char ∗conname;
       long index;

PARAMETERS

       ptfig               Pointer to the figure in which the connector should be seeked

       conname             Name of the connector

       index               Connector index

DESCRIPTION

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

RETURN VALUE

       getphcon returns a pointer to the given connector.

ERRORS

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

EXAMPLE

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

SEE ALSO

       mbk(1), phfig(3), phcon(3), addphcon(3), delphcon(3).