.\"   $Id: getlocon.3,v 1.1 2002/03/08 13:51:02 fred Exp $
.\" @(#)getlocon.2 2.11 91/08/22 ; Labo masi cao-vlsi; Author : Frederic Petrot
.if t \{\
.XS \n%
.ti 0.2i
getlocon
.XE
.XS2 \n%
.ti 0.2i
getlocon
.XE2 \}
.TH GETLOCON 3 "October 1, 1997" "ASIM/LIP6" "MBK LOGICAL FUNCTIONS"
.SH NAME
getlocon \- retrieve a logical connector
.so jessie/alliance/alc_origin.1.en.gz
.SH SYNOPSYS
.nf
.if n \{\
.ft B \}
.if t \{\
.ft CR \}
#include "mlo.h"
locon_list \(**getlocon(ptfig, name)
lofig_list \(**ptfig;
char \(**name;
.ft R
.fi
.SH PARAMETERS
.TP 20
\fIptfig\fP
Pointer to the figure in which the connector should be seeked
.TP
\fIname\fP
Name of the connector
.SH DESCRIPTION
\fBgetlocon\fP looks in the list of connectors of the logical model pointed
to by \fIptfig\fP for a connector identified by its \fIname\fP, since it
should be unique at a given hierachical level.
.SH RETURN VALUE
\fBgetlocon\fP returns a pointer to the given connector.
.SH ERRORS
.if n \{\
.ft B \}
.if t \{\
.ft CR \}
"\(**\(**\(** mbk error \(**\(**\(** getlocon impossible :
connector \fIname\fP doesn't exist in figure \fIptfig\->NAME\fP"
.ft R
.RS
No connector matches the name. 
.RE
.SH EXAMPLE
.ta 3n 6n 9n 12n 15n 18n 21n
.nf
.if n \{\
.ft B \}
.if t \{\
.ft CR \}
#include "mlo.h"
locon_list \(**exist(figname, conname)
char \(**figname, \(**conname;
{
   return getlocon(getlofig(figname), conname);   
}
.ft R
.fi
.SH SEE ALSO
.BR mbk (1),
.BR lofig (3),
.BR locon (3),
.BR addlocon (3),
.BR dellocon (3).


.so jessie/alliance/alc_bug_report.1.en.gz