getphcon(3)

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);   
}