NAME

       getlocon - retrieve a logical connector

SYNOPSYS

       #include "mlo.h"
       locon_list ∗getlocon(ptfig, name)
       lofig_list ∗ptfig;
       char ∗name;

PARAMETERS

       ptfig               Pointer to the figure in which the connector should be seeked

       name                Name of the connector

DESCRIPTION

       getlocon  looks  in  the  list  of  connectors  of  the logical model pointed to by ptfig for a connector
       identified by its name, since it should be unique at a given hierachical level.

RETURN VALUE

       getlocon returns a pointer to the given connector.

ERRORS

       "∗∗∗ mbk error ∗∗∗ getlocon impossible : connector name doesn't exist in figure ptfig->NAME"
              No connector matches the name.

EXAMPLE

       #include "mlo.h"
       locon_list ∗exist(figname, conname)
       char ∗figname, ∗conname;
       {
          return getlocon(getlofig(figname), conname);
       }

SEE ALSO

       mbk(1), lofig(3), locon(3), addlocon(3), dellocon(3).

ASIM/LIP6                                        October 1, 1997                                     GETLOCON(3)