getphcon.3alc - Man Page
retrieve a physical connector
Synopsis
#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).
Referenced By
addphcon.3alc(3), delphcon.3alc(3), phcon.3alc(3).
October 1, 1997 ASIM/LIP6 MBK PHYSICAL FUNCTIONS