getphcon(3)
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);
}