GETPHCON(3)						      MBK PHYSICAL FUNCTIONS						       GETPHCON(3)

NAME

       getphcon - retrieve a physical connector

ORIGIN

       This  software  belongs	to  the  ALLIANCE CAD SYSTEM developed by the ASIM team at LIP6 laboratory of Universite Pierre et Marie CURIE, in
       Paris, France.

       Web : http://asim.lip6.fr/recherche/alliance/
       E-mail : alliance-users@asim.lip6.fr

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

BUG REPORT

       This tool is under development at the ASIM department of the LIP6 laboratory.
       We need your feedback to improve documentation and tools.

ASIM
/LIP6							  October 1, 1997						       GETPHCON(3)