bionic (3) getphcon.3.gz

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).