getloins.3alc man page

getloins — retrieve a logical instance

Synopsis

#include "mlo.h"
loins_list ∗getloins(ptfig, name)
lofig_list ∗ptfig;
char ∗name;

Parameters

ptfig

Pointer to the figure in which the instance should be seeked

name

Name of the instance

Description

getloins looks in the list of instances of the logical model pointed to by ptfig for a instance identified by its name. This instance is unique, since the name is the instance identifier.

Return Value

getloins returns a pointer to the instance that matches the name.

Errors

"∗∗∗ mbk error ∗∗∗ illegal getloins instance name doesn't exist in figure ptfig->NAME"

No instance is called name in the figure.

Example

#include "mlo.h"
loins_list ∗get_ins_by_name(figname, insname)
char ∗figname, ∗insname;
{
   return getloins(getlofig(figname), insname);   
}

See Also

mbk(1), lofig(3), loins(3), addloins(3), delloins(3).

Referenced By

addloins.3alc(3), delloins.3alc(3), loins.3alc(3).

October 1, 1997 ASIM/LIP6 MBK LOGICAL FUNCTIONS