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