An PRMInterface is implemented by a Class<GUM_SCALAR> and defines a set of PRMReferenceSlot<GUM_SCALAR> and PRMAttribute<GUM_SCALAR> which the implementing Class<GUM_SCALAR> must contain. More...

#include <PRMClass.h>

Inheritance diagram for gum::prm::PRMInterface< GUM_SCALAR >:

Collaboration diagram for gum::prm::PRMInterface< GUM_SCALAR >:

Public Member Functions
Constructor & destructor.
	PRMInterface (const std::string &name)
	Default constructor. More...

	PRMInterface (const std::string &name, PRMInterface< GUM_SCALAR > &super, bool delayInheritance=false)
	Constructor for building a subclass of super. More...

	PRMInterface (const PRMInterface< GUM_SCALAR > &source)
	Copy constructor. More...

virtual	~PRMInterface ()
	Destructor. More...

Graphical model getters and setters
virtual PRMObject::prm_type	obj_type () const
	Implementation of pure virtual method of PRMObject. More...

virtual PRMClassElement< GUM_SCALAR > &	get (NodeId id)
	See gum::prm::PRMClassElementContainer<GUM_SCALAR>::get(NodeId). More...

virtual const PRMClassElement< GUM_SCALAR > &	get (NodeId id) const
	Se gum::prm::PRMClassElementContainer<GUM_SCALAR>::get(NodeId). More...

void	addArc (const std::string &tail, const std::string &head)
	An Interfance doesn't have any arc, this will raise an OperationNotAllowed exception. More...

PRMClassElement<GUM_SCALAR> getters and setters
virtual bool	isOutputNode (const PRMClassElement< GUM_SCALAR > &elt) const
	See gum::prm::PRMClassElementContainer<GUM_SCALAR>::get(const std::string&). More...

virtual PRMClassElement< GUM_SCALAR > &	get (const std::string &name)
	See gum::prm::PRMClassElementContainer<GUM_SCALAR>::get(const std::string&). More...

virtual const PRMClassElement< GUM_SCALAR > &	get (const std::string &name) const
	See gum::prm::PRMClassElementContainer<GUM_SCALAR>::get(const std::string&). More...

const Set< PRMAttribute< GUM_SCALAR > *> &	attributes () const
	Returns the set of PRMAttribute<GUM_SCALAR> of this Class<GUM_SCALAR>. More...

const Set< PRMReferenceSlot< GUM_SCALAR > *> &	referenceSlots () const
	Returns the set of PRMAggregate of this Class<GUM_SCALAR>. More...

NodeId	add (PRMClassElement< GUM_SCALAR > *elt)
	See gum::prm::PRMClassElementContainer<GUM_SCALAR>::add(PRMClassElement<GUM_SCALAR>*). More...

NodeId	overload (PRMClassElement< GUM_SCALAR > *elt)
	Add a new PRMClassElement<GUM_SCALAR> which overload an inherited PRMClassElement<GUM_SCALAR>. More...

Inheritance methods
virtual bool	isSubTypeOf (const PRMClassElementContainer< GUM_SCALAR > &cec) const
	Test if this PRMInterface is a sub PRMInterface of cec. More...

PRMInterface< GUM_SCALAR > &	super ()
	Returns the superInterface of this PRMInterface. More...

const PRMInterface< GUM_SCALAR > &	super () const
	Returns the superInterface of this PRMInterface. More...

Set< PRMClass< GUM_SCALAR > *> &	implementations ()
	Returns the set of Class<GUM_SCALAR> implementing this PRMInterface. More...

const Set< PRMClass< GUM_SCALAR > *> &	implementations () const
	Returns the set of Class<GUM_SCALAR> implementing this PRMInterface. More...

void	inheritInterface ()
	Inherits from this interface super interface, this should only be done when this inteface inheritance was delayed. More...

Getters & setters operators
PRMClassElement< GUM_SCALAR > &	operator[] (NodeId id)
	See gum::prm::PRMClassElementContainer<GUM_SCALAR>::operator[](NodeId). More...

const PRMClassElement< GUM_SCALAR > &	operator[] (NodeId id) const
	See gum::prm::PRMClassElementContainer<GUM_SCALAR>::operator[](NodeId). More...

PRMClassElement< GUM_SCALAR > &	operator[] (const std::string &name)
	See gum::prm::PRMClassElementContainer<GUM_SCALAR>::operator[](const std::string&). More...

const PRMClassElement< GUM_SCALAR > &	operator[] (const std::string &name) const
	See gum::prm::PRMClassElementContainer<GUM_SCALAR>::operator[](const std::string&). More...

Getters on the gum::PRMClassElement<GUM_SCALAR>.
virtual bool	belongsTo (const PRMClassElement< GUM_SCALAR > &elt) const
	Returns true if elt belongs to this PRMClassElementContainer. More...

virtual bool	exists (const std::string &name) const
	Returns true if a member with the given name exists in this PRMClassElementContainer or in the PRMClassElementContainer hierarchy. More...

virtual bool	isInputNode (const PRMClassElement< GUM_SCALAR > &elt) const
	Returns true if the node is an input node. More...

virtual void	setInputNode (const PRMClassElement< GUM_SCALAR > &elt, bool b)
	Set the input flag value of id at b. More...

virtual void	setOutputNode (const PRMClassElement< GUM_SCALAR > &elt, bool b)
	Set the output flag value of id at b. More...

virtual bool	isInnerNode (const PRMClassElement< GUM_SCALAR > &elt) const
	Returns true if the node is an inner node. More...

Graphical operator
virtual bool	exists (NodeId id) const
	Returns true if a member with the given id exists in this PRMClassElementContainer or in the PRMClassElementContainer hierarchy. More...

virtual const DAG &	containerDag () const
	Returns the gum::DAG of this PRMClassElementContainer. More...

Inheritance getters and setters
virtual bool	isSuperTypeOf (const PRMClassElementContainer< GUM_SCALAR > &cec) const
	Test if this PRMClassElementContainer is a super type of cec. More...

Getters & setters.
const std::string &	name () const
	Returns the name of this object. More...

void	name (const std::string &name)
	Change the name of the PRM Object. More...

Operators
bool	operator== (const PRMObject &obj) const
	To PRMObject are equal if they have the same name (which is unique). More...

bool	operator!= (const PRMObject &obj) const
	To PRMObject are equal if they have the same name (which is unique). More...

Protected Member Functions
const DAG &	dag_ () const
	Returns a constant reference over this PRMInterface's DAG. More...

DAG &	dag_ ()
	Returns a non constant reference over this PRMInterface's DAG. More...

void	findAllSubtypes_ (Set< PRMClassElementContainer< GUM_SCALAR > * > &set)
	Fills set with all the subtypes of this PRMInterface, this includes extensions and implementations. More...

void	updateDescendants_ (const PRMClassElement< GUM_SCALAR > &elt)
	See gum::prm::PRMClassElementContainer<GUM_SCALAR>(const PRMClassElement<GUM_SCALAR>&). More...

virtual std::pair< bool, bool > &	getIOFlag_ (const PRMClassElement< GUM_SCALAR > &elt)
	Returns the IO flags of a PRMClassElement<GUM_SCALAR>. More...

virtual const std::pair< bool, bool > &	getIOFlag_ (const PRMClassElement< GUM_SCALAR > &elt) const
	Returns the IO flags of a PRMClassElement<GUM_SCALAR>. More...

virtual void	setIOFlag_ (const PRMClassElement< GUM_SCALAR > &elt, const std::pair< bool, bool > &flags)
	Defines the IO flags of a PRMClassElement<GUM_SCALAR>. More...

virtual void	copyIOFlags_ (const PRMClassElementContainer< GUM_SCALAR > &c)
	Copy the IO Flags of c in this PRMClassElementContainer. More...

Friends
class	PRMClass< GUM_SCALAR >

Iterators
typedef NodeProperty< PRMClassElement< GUM_SCALAR > *>::iterator	ClassEltIterator

typedef NodeProperty< PRMClassElement< GUM_SCALAR > *>::const_iterator	const_ClassEltIterator

ClassEltIterator	begin ()

const ClassEltIterator &	end ()

const_ClassEltIterator	begin () const

const const_ClassEltIterator &	end () const

Inheritance members
PRMInterface< GUM_SCALAR > *	superInterface__
	The alternate PRMClassElementContainer<GUM_SCALAR> searched for elements defined in this. Note that this is first searched for gum::PRMClassElement<GUM_SCALAR>. More...

Set< PRMClass< GUM_SCALAR > *>	implementations__
	The set of Class<GUM_SCALAR> which implements this PRMInterface. More...

Set< PRMInterface< GUM_SCALAR > *>	extensions__
	The set of Class<GUM_SCALAR> which implements this PRMInterface. More...

void	addImplementation__ (PRMClass< GUM_SCALAR > *c)
	Add an Class<GUM_SCALAR> to the set of Class<GUM_SCALAR> which implements this PRMInterface. More...

void	addExtension__ (PRMInterface< GUM_SCALAR > *c)
	Add an Class<GUM_SCALAR> to the set of Class<GUM_SCALAR> which implements this PRMInterface. More...

bool	checkOverloadLegality__ (const PRMClassElement< GUM_SCALAR > overloaded, const PRMClassElement< GUM_SCALAR > overloader)
	The alternate PRMClassElementContainer<GUM_SCALAR> searched for elements defined in this. Note that this is first searched for gum::PRMClassElement<GUM_SCALAR>. More...

void	overloadAttribute__ (PRMAttribute< GUM_SCALAR > overloader, PRMAttribute< GUM_SCALAR > overloaded)
	The alternate PRMClassElementContainer<GUM_SCALAR> searched for elements defined in this. Note that this is first searched for gum::PRMClassElement<GUM_SCALAR>. More...

void	overloadReferenceSlot__ (PRMReferenceSlot< GUM_SCALAR > overloader, PRMReferenceSlot< GUM_SCALAR > overloaded)
	The alternate PRMClassElementContainer<GUM_SCALAR> searched for elements defined in this. Note that this is first searched for gum::PRMClassElement<GUM_SCALAR>. More...

void	addCastDescendants__ (PRMAttribute< GUM_SCALAR > start, PRMAttribute< GUM_SCALAR > end)
	The alternate PRMClassElementContainer<GUM_SCALAR> searched for elements defined in this. Note that this is first searched for gum::PRMClassElement<GUM_SCALAR>. More...

Built-in types.
enum	prm_type : char { prm_type::ALL, prm_type::CLASS, prm_type::PRM_INTERFACE, prm_type::CLASS_ELT, prm_type::TYPE, prm_type::SYSTEM, prm_type::INSTANCE }
	Enumeration of the different types of objects handled by a PRM. More...

static std::string	LEFT_CAST ()
	Enumeration of the different types of objects handled by a PRM. More...

static std::string	RIGHT_CAST ()
	Enumeration of the different types of objects handled by a PRM. More...

static std::string	enum2str (prm_type type)
	Returns the string representation of a PRMObject. More...

static INLINE bool	isClass (const PRMObject &obj)
	Returns true if obj_ptr is of type Class. More...

static INLINE bool	isInterface (const PRMObject &obj)
	Returns true if obj_ptr is of type PRMInterface. More...

static INLINE bool	isInstance (const PRMObject &obj)
	Returns true if obj_ptr is of type PRMInstance. More...

Detailed Description

template<typename GUM_SCALAR>
class gum::prm::PRMInterface< GUM_SCALAR >

An PRMInterface is implemented by a Class<GUM_SCALAR> and defines a set of PRMReferenceSlot<GUM_SCALAR> and PRMAttribute<GUM_SCALAR> which the implementing Class<GUM_SCALAR> must contain.

See also: PRM Class<GUM_SCALAR> PRMClassElement<GUM_SCALAR>

Definition at line 53 of file PRMClass.h.

Member Typedef Documentation

◆ ClassEltIterator

template<typename GUM_SCALAR>

typedef NodeProperty< PRMClassElement< GUM_SCALAR >* >::iterator gum::prm::PRMInterface< GUM_SCALAR >::ClassEltIterator

Definition at line 284 of file PRMInterface.h.

◆ const_ClassEltIterator

template<typename GUM_SCALAR>

typedef NodeProperty< PRMClassElement< GUM_SCALAR >* >::const_iterator gum::prm::PRMInterface< GUM_SCALAR >::const_ClassEltIterator

Definition at line 290 of file PRMInterface.h.

Member Enumeration Documentation

◆ prm_type

enum gum::prm::PRMObject::prm_type : char

stronginherited

Enumeration of the different types of objects handled by a PRM.

The "all" type is used to tell that we want any kind of PRMType (useful with iterators for example). No PRMObject will ever have "all" as type.

Enumerator
ALL
CLASS
PRM_INTERFACE
CLASS_ELT
TYPE
SYSTEM
INSTANCE

Definition at line 68 of file PRMObject.h.

                           : char
       {
         ALL,
         CLASS,
         PRM_INTERFACE,
         CLASS_ELT,
         TYPE,
         SYSTEM,
         INSTANCE
       };

Constructor & Destructor Documentation

◆ PRMInterface() [1/3]

template<typename GUM_SCALAR >

gum::prm::PRMInterface< GUM_SCALAR >::PRMInterface ( const std::string & name )

explicit

Default constructor.

Parameters

name	The interface name.

Definition at line 36 of file PRMInterface_tpl.h.

                                                                   :
         PRMClassElementContainer< GUM_SCALAR >(name), superInterface__(0) {
       GUM_CONSTRUCTOR(PRMInterface);
     }

◆ PRMInterface() [2/3]

template<typename GUM_SCALAR>

gum::prm::PRMInterface< GUM_SCALAR >::PRMInterface	(	const std::string &	name,
		PRMInterface< GUM_SCALAR > &	super,
		bool	delayInheritance = `false`
	)

Constructor for building a subclass of super.

Parameters

name	The sub-interface name.
super	The super PRMInterface of this.
delayInheritance	If true, inheritance will be delayed.

Definition at line 42 of file PRMInterface_tpl.h.

                                                                     :
         PRMClassElementContainer< GUM_SCALAR >(name),
         superInterface__(&super) {
       GUM_CONSTRUCTOR(PRMInterface);
       if (!delayInheritance) { inheritInterface__(super); }
     }

◆ PRMInterface() [3/3]

template<typename GUM_SCALAR>

gum::prm::PRMInterface< GUM_SCALAR >::PRMInterface ( const PRMInterface< GUM_SCALAR > & source )

Copy constructor.

Definition at line 52 of file PRMInterface_tpl.h.

                                                  :
         PRMClassElementContainer< GUM_SCALAR >(source.name()),
         dag__(source.dag__), superInterface__(source.superInterface__) {
       GUM_CONS_CPY(PRMInterface);
       GUM_ERROR(FatalError, "don't copy an interface");
     }

◆ ~PRMInterface()

template<typename GUM_SCALAR >

gum::prm::PRMInterface< GUM_SCALAR >::~PRMInterface ( )

virtual

Destructor.

Definition at line 61 of file PRMInterface_tpl.h.

                                               {
       GUM_DESTRUCTOR(PRMInterface);
 
       for (const auto& elt: nodeIdMap__) {
         delete elt.second;
       }
     }

Member Function Documentation

◆ add()

template<typename GUM_SCALAR>

NodeId gum::prm::PRMInterface< GUM_SCALAR >::add ( PRMClassElement< GUM_SCALAR > * elt )

virtual

See gum::prm::PRMClassElementContainer<GUM_SCALAR>::add(PRMClassElement<GUM_SCALAR>*).

Implements gum::prm::PRMClassElementContainer< GUM_SCALAR >.

Definition at line 115 of file PRMInterface_tpl.h.

                                                                              {
       if (nameMap__.exists(elt->name())) {
         GUM_ERROR(DuplicateElement,
                   "name '" << elt->name()
                            << "' is already used by another ClassElement");
       }
 
       if (PRMClassElement< GUM_SCALAR >::isAttribute(*elt)) {
         PRMAttribute< GUM_SCALAR >* attr
            = static_cast< PRMAttribute< GUM_SCALAR >* >(elt);
         nameMap__.insert(attr->name(), attr);
 
         while (true) {
           attr->setId(nextNodeId());
           dag__.addNodeWithId(attr->id());
           nodeIdMap__.insert(attr->id(), attr);
           nameMap__.insert(attr->safeName(), attr);
           attributes__.insert(attr);
 
           if (attr->type().isSubType()) {
             attr = attr->getCastDescendant();
           } else {
             break;
           }
         }
       } else if (PRMClassElement< GUM_SCALAR >::isReferenceSlot(*elt)) {
         elt->setId(nextNodeId());
         dag__.addNodeWithId(elt->id());
         nodeIdMap__.insert(elt->id(), elt);
         referenceSlots__.insert(
            static_cast< PRMReferenceSlot< GUM_SCALAR >* >(elt));
         nameMap__.insert(elt->name(), elt);
         nameMap__.insert(elt->safeName(), elt);
       } else {
         GUM_ERROR(WrongClassElement,
                   "illegal ClassElement<GUM_SCALAR> for an Interface");
       }
 
       return elt->id();
     }

◆ addArc()

template<typename GUM_SCALAR >

INLINE void gum::prm::PRMInterface< GUM_SCALAR >::addArc	(	const std::string &	tail,
		const std::string &	head
	)

virtual

An Interfance doesn't have any arc, this will raise an OperationNotAllowed exception.

Parameters

tail	The tail of the added arc.
head	The head of the added arc.

Exceptions

OperationNotAllowed Systematically throws an OperationNotAllowed.

Implements gum::prm::PRMClassElementContainer< GUM_SCALAR >.

Definition at line 367 of file PRMInterface_tpl.h.

                                                                           {
       GUM_ERROR(OperationNotAllowed, "an Interface does ! have arcs");
     }

◆ addCastDescendants__()

template<typename GUM_SCALAR>

void gum::prm::PRMInterface< GUM_SCALAR >::addCastDescendants__	(	PRMAttribute< GUM_SCALAR > *	start,
		PRMAttribute< GUM_SCALAR > *	end
	)

private

The alternate PRMClassElementContainer<GUM_SCALAR> searched for elements defined in this. Note that this is first searched for gum::PRMClassElement<GUM_SCALAR>.

Definition at line 256 of file PRMInterface_tpl.h.

                                         {
       PRMAttribute< GUM_SCALAR >* parent = start;
       PRMAttribute< GUM_SCALAR >* child  = nullptr;
 
       while (parent->type().superType() != end->type()) {
         child = parent->getCastDescendant();
         child->setId(nextNodeId());
         dag__.addNodeWithId(child->id());
         nodeIdMap__.insert(child->id(), child);
         // Only use child's safe name when adding to the name map!
         nameMap__.insert(child->safeName(), child);
         attributes__.insert(child);
         // Do ! use Class<GUM_SCALAR>::insertArc(), child's CPF is already
         // initialized properly
         parent = child;
       }
 
       parent->setAsCastDescendant(end);
     }

◆ addExtension__()

template<typename GUM_SCALAR>

INLINE void gum::prm::PRMInterface< GUM_SCALAR >::addExtension__ ( PRMInterface< GUM_SCALAR > * c )

private

Add an Class<GUM_SCALAR> to the set of Class<GUM_SCALAR> which implements this PRMInterface.

Definition at line 397 of file PRMInterface_tpl.h.

                                                                                {
       extensions__.insert(i);
     }

◆ addImplementation__()

template<typename GUM_SCALAR>

INLINE void gum::prm::PRMInterface< GUM_SCALAR >::addImplementation__ ( PRMClass< GUM_SCALAR > * c )

private

Add an Class<GUM_SCALAR> to the set of Class<GUM_SCALAR> which implements this PRMInterface.

Definition at line 391 of file PRMInterface_tpl.h.

                                                                                 {
       implementations__.insert(c);
     }

◆ attributes()

template<typename GUM_SCALAR >

INLINE const Set< PRMAttribute< GUM_SCALAR > *> & gum::prm::PRMInterface< GUM_SCALAR >::attributes ( ) const

Returns the set of PRMAttribute<GUM_SCALAR> of this Class<GUM_SCALAR>.

Returns: Returns the set of PRMAttribute<GUM_SCALAR> of this Class<GUM_SCALAR>.

Definition at line 483 of file PRMInterface_tpl.h.

                                                               {
       return attributes__;
     }

◆ begin() [1/2]

template<typename GUM_SCALAR >

INLINE PRMInterface< GUM_SCALAR >::ClassEltIterator gum::prm::PRMInterface< GUM_SCALAR >::begin ( )

Definition at line 344 of file PRMInterface_tpl.h.

                                          {
       return nodeIdMap__.begin();
     }

◆ begin() [2/2]

template<typename GUM_SCALAR >

INLINE PRMInterface< GUM_SCALAR >::const_ClassEltIterator gum::prm::PRMInterface< GUM_SCALAR >::begin ( ) const

Definition at line 356 of file PRMInterface_tpl.h.

                                                {
       return nodeIdMap__.begin();
     }

◆ belongsTo()

template<typename GUM_SCALAR>

INLINE bool gum::prm::PRMClassElementContainer< GUM_SCALAR >::belongsTo ( const PRMClassElement< GUM_SCALAR > & elt ) const

virtualinherited

Returns true if elt belongs to this PRMClassElementContainer.

Parameters

elt	A PRMClassElement<GUM_SCALAR>.

Returns: true if elt beglons to this PRMClassElementContainer.

Definition at line 178 of file PRMClassElementContainer_tpl.h.

                                                        {
       try {
         return &elt == &(get(elt.safeName()));
       } catch (NotFound&) { return false; }
     }

◆ checkOverloadLegality__()

template<typename GUM_SCALAR>

bool gum::prm::PRMInterface< GUM_SCALAR >::checkOverloadLegality__	(	const PRMClassElement< GUM_SCALAR > *	overloaded,
		const PRMClassElement< GUM_SCALAR > *	overloader
	)

private

The alternate PRMClassElementContainer<GUM_SCALAR> searched for elements defined in this. Note that this is first searched for gum::PRMClassElement<GUM_SCALAR>.

Definition at line 279 of file PRMInterface_tpl.h.

                                                         {
       if (overloaded->elt_type() != overloader->elt_type()) { return false; }
 
       if (overloaded->elt_type() == PRMClassElement< GUM_SCALAR >::prm_attribute) {
         if (!overloader->type().isSubTypeOf(overloaded->type())) { return false; }
       } else if (overloaded->elt_type()
                  == PRMClassElement< GUM_SCALAR >::prm_refslot) {
         auto ref_overloader
            = static_cast< const PRMReferenceSlot< GUM_SCALAR >* >(overloader);
         auto ref_overloaded
            = static_cast< const PRMReferenceSlot< GUM_SCALAR >* >(overloaded);
         if (!ref_overloader->slotType().isSubTypeOf(ref_overloaded->slotType())) {
           return false;
         }
       } else {
         return false;
       }
       return true;
     }

◆ containerDag()

template<typename GUM_SCALAR >

INLINE const DAG & gum::prm::PRMClassElementContainer< GUM_SCALAR >::containerDag ( ) const

virtualinherited

Returns the gum::DAG of this PRMClassElementContainer.

Be very careful when using NodeId with PRMClassElement<GUM_SCALAR>: there is no guarantee that an inherited PRMClassElement<GUM_SCALAR> will have the same NodeId than its superclass counterpart.

When dealing with different classes and interfaces ALWAYS use safe-name as identifier.

Returns: the DAG of this PRMClassElementContainer.

Definition at line 187 of file PRMClassElementContainer_tpl.h.

                                                                             {
       return dag_();
     }

◆ copyIOFlags_()

template<typename GUM_SCALAR>

void gum::prm::PRMClassElementContainer< GUM_SCALAR >::copyIOFlags_ ( const PRMClassElementContainer< GUM_SCALAR > & c )

protectedvirtualinherited

Copy the IO Flags of c in this PRMClassElementContainer.

Parameters

c	A PRMClassElementContainer.

Definition at line 36 of file PRMClassElementContainer_tpl.h.

                                                         {
       for (const auto& flag: c.IOFlags__)
         setIOFlag_(get(flag.first), flag.second);
     }

◆ dag_() [1/2]

template<typename GUM_SCALAR >

INLINE const DAG & gum::prm::PRMInterface< GUM_SCALAR >::dag_ ( ) const

protectedvirtual

Returns a constant reference over this PRMInterface's DAG.

Implements gum::prm::PRMClassElementContainer< GUM_SCALAR >.

Definition at line 432 of file PRMInterface_tpl.h.

                                                              {
       return dag__;
     }

◆ dag_() [2/2]

template<typename GUM_SCALAR >

INLINE DAG & gum::prm::PRMInterface< GUM_SCALAR >::dag_ ( )

protectedvirtual

Returns a non constant reference over this PRMInterface's DAG.

Implements gum::prm::PRMClassElementContainer< GUM_SCALAR >.

Definition at line 437 of file PRMInterface_tpl.h.

                                                  {
       return dag__;
     }

◆ end() [1/2]

template<typename GUM_SCALAR >

INLINE const PRMInterface< GUM_SCALAR >::ClassEltIterator & gum::prm::PRMInterface< GUM_SCALAR >::end ( )

Definition at line 350 of file PRMInterface_tpl.h.

                                        {
       return nodeIdMap__.end();
     }

◆ end() [2/2]

template<typename GUM_SCALAR >

INLINE const PRMInterface< GUM_SCALAR >::const_ClassEltIterator & gum::prm::PRMInterface< GUM_SCALAR >::end ( ) const

Definition at line 362 of file PRMInterface_tpl.h.

                                              {
       return nodeIdMap__.end();
     }

◆ enum2str()

static std::string gum::prm::PRMObject::enum2str ( prm_type type )

inlinestaticinherited

Returns the string representation of a PRMObject.

Definition at line 83 of file PRMObject.h.

                                                {
         switch (type) {
           case prm_type::CLASS:
             return "PRMType::CLASS";
 
           case prm_type::CLASS_ELT:
             return "PRMType::CLASS_ELT";
 
           case prm_type::TYPE:
             return "PRMType::TYPE";
 
           case prm_type::SYSTEM:
             return "PRMType::SYSTEM";
 
           case prm_type::INSTANCE:
             return "PRMType::INSTANCE";
 
           case prm_type::PRM_INTERFACE:
             return "PRMType::PRM_INTERFACE";
 
           default:
             return "unknown";
         }
       }

◆ exists() [1/2]

template<typename GUM_SCALAR >

INLINE bool gum::prm::PRMClassElementContainer< GUM_SCALAR >::exists ( const std::string & name ) const

virtualinherited

Returns true if a member with the given name exists in this PRMClassElementContainer or in the PRMClassElementContainer hierarchy.

Definition at line 169 of file PRMClassElementContainer_tpl.h.

                                     {
       try {
         get(name);
         return true;
       } catch (NotFound&) { return false; }
     }

◆ exists() [2/2]

template<typename GUM_SCALAR >

INLINE bool gum::prm::PRMClassElementContainer< GUM_SCALAR >::exists ( NodeId id ) const

virtualinherited

Returns true if a member with the given id exists in this PRMClassElementContainer or in the PRMClassElementContainer hierarchy.

Parameters

id A NodeId.

Returns: true if id matches a PRMClassElement<GUM_SCALAR>.

Definition at line 164 of file PRMClassElementContainer_tpl.h.

                                                                               {
       return containerDag().exists(id);
     }

◆ findAllSubtypes_()

template<typename GUM_SCALAR>

void gum::prm::PRMInterface< GUM_SCALAR >::findAllSubtypes_ ( Set< PRMClassElementContainer< GUM_SCALAR > * > & set )

protectedvirtual

Fills set with all the subtypes of this PRMInterface, this includes extensions and implementations.

Implements gum::prm::PRMClassElementContainer< GUM_SCALAR >.

Definition at line 506 of file PRMInterface_tpl.h.

                                                             {
       for (const auto impl: implementations__) {
         set.insert(impl);
         impl->findAllSubtypes_(set);
       }
 
       for (const auto ext: extensions__) {
         set.insert(ext);
         ext->findAllSubtypes_(set);
       }
     }

◆ get() [1/4]

template<typename GUM_SCALAR >

INLINE PRMClassElement< GUM_SCALAR > & gum::prm::PRMInterface< GUM_SCALAR >::get ( NodeId id )

virtual

See gum::prm::PRMClassElementContainer<GUM_SCALAR>::get(NodeId).

Implements gum::prm::PRMClassElementContainer< GUM_SCALAR >.

Definition at line 443 of file PRMInterface_tpl.h.

                                                     {
       try {
         return *(nodeIdMap__[id]);
       } catch (NotFound&) {
         GUM_ERROR(NotFound, "no ClassElement<GUM_SCALAR> with the given NodeId");
       }
     }

◆ get() [2/4]

template<typename GUM_SCALAR >

INLINE const PRMClassElement< GUM_SCALAR > & gum::prm::PRMInterface< GUM_SCALAR >::get ( NodeId id ) const

virtual

Se gum::prm::PRMClassElementContainer<GUM_SCALAR>::get(NodeId).

Implements gum::prm::PRMClassElementContainer< GUM_SCALAR >.

Definition at line 453 of file PRMInterface_tpl.h.

                                                                 {
       try {
         return *(nodeIdMap__[id]);
       } catch (NotFound&) {
         GUM_ERROR(NotFound, "no ClassElement<GUM_SCALAR> with the given NodeId");
       }
     }

◆ get() [3/4]

template<typename GUM_SCALAR >

INLINE PRMClassElement< GUM_SCALAR > & gum::prm::PRMInterface< GUM_SCALAR >::get ( const std::string & name )

virtual

See gum::prm::PRMClassElementContainer<GUM_SCALAR>::get(const std::string&).

Implements gum::prm::PRMClassElementContainer< GUM_SCALAR >.

Definition at line 463 of file PRMInterface_tpl.h.

                                                                 {
       try {
         return *(nameMap__[name]);
       } catch (NotFound&) {
         GUM_ERROR(NotFound, "no ClassElement<GUM_SCALAR> with the given name");
       }
     }

◆ get() [4/4]

template<typename GUM_SCALAR >

INLINE const PRMClassElement< GUM_SCALAR > & gum::prm::PRMInterface< GUM_SCALAR >::get ( const std::string & name ) const

virtual

See gum::prm::PRMClassElementContainer<GUM_SCALAR>::get(const std::string&).

Implements gum::prm::PRMClassElementContainer< GUM_SCALAR >.

Definition at line 473 of file PRMInterface_tpl.h.

                                                                             {
       try {
         return *(nameMap__[name]);
       } catch (NotFound&) {
         GUM_ERROR(NotFound, "no ClassElement<GUM_SCALAR> with the given name");
       }
     }

◆ getIOFlag_() [1/2]

template<typename GUM_SCALAR>

INLINE std::pair< bool, bool > & gum::prm::PRMClassElementContainer< GUM_SCALAR >::getIOFlag_ ( const PRMClassElement< GUM_SCALAR > & elt )

protectedvirtualinherited

Returns the IO flags of a PRMClassElement<GUM_SCALAR>.

Parameters

elt	The PRMClassElement<GUM_SCALAR>.

Returns: elt's IO flags.

Exceptions

NotFound Raised if elt does not have any IO flags.

Definition at line 132 of file PRMClassElementContainer_tpl.h.

                                                     {
       try {
         return IOFlags__[elt.safeName()];
       } catch (NotFound&) {
         GUM_ERROR(NotFound,
                   "this ClassElement<GUM_SCALAR> does not have any IO flags");
       }
     }

◆ getIOFlag_() [2/2]

template<typename GUM_SCALAR>

INLINE const std::pair< bool, bool > & gum::prm::PRMClassElementContainer< GUM_SCALAR >::getIOFlag_ ( const PRMClassElement< GUM_SCALAR > & elt ) const

protectedvirtualinherited

Returns the IO flags of a PRMClassElement<GUM_SCALAR>.

Parameters

elt	The PRMClassElement<GUM_SCALAR>.

Returns: elt's IO flags.

Exceptions

NotFound Raised if elt does not have any IO flags.

Definition at line 144 of file PRMClassElementContainer_tpl.h.

                                                           {
       try {
         return IOFlags__[elt.safeName()];
       } catch (NotFound&) {
         GUM_ERROR(NotFound,
                   "this ClassElement<GUM_SCALAR> does not have any IO flags");
       }
     }

◆ implementations() [1/2]

template<typename GUM_SCALAR >

INLINE Set< PRMClass< GUM_SCALAR > *> & gum::prm::PRMInterface< GUM_SCALAR >::implementations ( )

Returns the set of Class<GUM_SCALAR> implementing this PRMInterface.

Definition at line 495 of file PRMInterface_tpl.h.

                                                        {
       return implementations__;
     }

◆ implementations() [2/2]

template<typename GUM_SCALAR >

INLINE const Set< PRMClass< GUM_SCALAR > *> & gum::prm::PRMInterface< GUM_SCALAR >::implementations ( ) const

Returns the set of Class<GUM_SCALAR> implementing this PRMInterface.

Definition at line 501 of file PRMInterface_tpl.h.

                                                                    {
       return implementations__;
     }

◆ inheritInterface()

template<typename GUM_SCALAR >

void gum::prm::PRMInterface< GUM_SCALAR >::inheritInterface ( )

Inherits from this interface super interface, this should only be done when this inteface inheritance was delayed.

Definition at line 70 of file PRMInterface_tpl.h.

                                                       {
       if (superInterface__ != nullptr) { inheritInterface__(*superInterface__); }
     }

◆ inheritInterface__()

template<typename GUM_SCALAR>

void gum::prm::PRMInterface< GUM_SCALAR >::inheritInterface__ ( const PRMInterface< GUM_SCALAR > & i )

private

Proceed with the copy of i in this.

Definition at line 75 of file PRMInterface_tpl.h.

                                             {
       // Copying attributes
       for (const auto i_attr: i.attributes__) {
         auto attr
            = new PRMScalarAttribute< GUM_SCALAR >(i_attr->name(), i_attr->type());
         attr->setId(i_attr->id());
         nodeIdMap__.insert(attr->id(), attr);
         attributes__.insert(attr);
 
         if (i.nameMap__[i_attr->name()] == i.nameMap__[i_attr->safeName()]) {
           nameMap__.insert(attr->name(), attr);
         }
 
         nameMap__.insert(attr->safeName(), attr);
         dag__.addNodeWithId(attr->id());
       }
 
       // Copying reference slots
       for (const auto i_ref: i.referenceSlots__) {
         auto ref = new PRMReferenceSlot< GUM_SCALAR >(
            i_ref->name(),
            const_cast< PRMClassElementContainer< GUM_SCALAR >& >(
               i_ref->slotType()),
            i_ref->isArray());
 
         ref->setId(i_ref->id());
         nodeIdMap__.insert(ref->id(), ref);
         referenceSlots__.insert(ref);
 
         if (i.nameMap__.exists(ref->name())) {
           nameMap__.insert(ref->name(), ref);
         }
 
         nameMap__.insert(ref->safeName(), ref);
         dag__.addNodeWithId(ref->id());
       }
     }

◆ isClass()

static INLINE bool gum::prm::PRMObject::isClass ( const PRMObject & obj )

inlinestaticinherited

Returns true if obj_ptr is of type Class.

Definition at line 109 of file PRMObject.h.

References gum::prm::PRMObject::PRMObject().

                                                        {
         return obj.obj_type() == prm_type::CLASS;
       }

Here is the call graph for this function:

◆ isInnerNode()

template<typename GUM_SCALAR>

INLINE bool gum::prm::PRMClassElementContainer< GUM_SCALAR >::isInnerNode ( const PRMClassElement< GUM_SCALAR > & elt ) const

virtualinherited

Returns true if the node is an inner node.

PRMAttribute or PRMAggregate can either be input, output, both or internal nodes.

By defaut, attributes and aggregates are inner nodes.

Parameters

elt	A PRMClassElement<GUM_SCALAR>.

Returns: true if elt is an inner node.

Exceptions

NotFound	Raised if NodeId does'nt match any PRMClassElement<GUM_SCALAR> in this.
WrongClassElement	Raised if NodeId is neither an PRMAttribute nor an PRMAggregate.

Definition at line 117 of file PRMClassElementContainer_tpl.h.

                                                        {
       try {
         return !(getIOFlag_(elt).first || getIOFlag_(elt).second);
       } catch (NotFound&) { return true; }
     }

◆ isInputNode()

template<typename GUM_SCALAR>

INLINE bool gum::prm::PRMClassElementContainer< GUM_SCALAR >::isInputNode ( const PRMClassElement< GUM_SCALAR > & elt ) const

virtualinherited

Returns true if the node is an input node.

PRMAttribute or PRMAggregate can either be input, output, both or internal nodes.

By defaut, attributes and aggregates are inner nodes.

Parameters

elt	A PRMClassElement<GUM_SCALAR>.

Returns: Returns true if id is an input node.

Definition at line 71 of file PRMClassElementContainer_tpl.h.

                                                        {
       try {
         return getIOFlag_(elt).first;
       } catch (NotFound&) { return false; }
     }

◆ isInstance()

static INLINE bool gum::prm::PRMObject::isInstance ( const PRMObject & obj )

inlinestaticinherited

Returns true if obj_ptr is of type PRMInstance.

Definition at line 119 of file PRMObject.h.

References gum::prm::PRMObject::PRMObject().

                                                           {
         return obj.obj_type() == prm_type::INSTANCE;
       }

Here is the call graph for this function:

◆ isInterface()

static INLINE bool gum::prm::PRMObject::isInterface ( const PRMObject & obj )

inlinestaticinherited

Returns true if obj_ptr is of type PRMInterface.

Definition at line 114 of file PRMObject.h.

References gum::prm::PRMObject::PRMObject().

                                                            {
         return obj.obj_type() == prm_type::PRM_INTERFACE;
       }

Here is the call graph for this function:

◆ isOutputNode()

template<typename GUM_SCALAR>

INLINE bool gum::prm::PRMInterface< GUM_SCALAR >::isOutputNode ( const PRMClassElement< GUM_SCALAR > & elt ) const

virtual

See gum::prm::PRMClassElementContainer<GUM_SCALAR>::get(const std::string&).

Implements gum::prm::PRMClassElementContainer< GUM_SCALAR >.

Definition at line 520 of file PRMInterface_tpl.h.

                                                        {
       try {
         if (!this->getIOFlag_(elt).second) {
           for (auto i: implementations__) {
             if (i->isOutputNode(elt)) { return true; }
           }
 
           if (superInterface__ && superInterface__->isOutputNode(elt)) {
             return true;
           }
 
         } else {
           return true;
         }
       } catch (NotFound&) {}
       return false;
     }

◆ isSubTypeOf()

template<typename GUM_SCALAR>

bool gum::prm::PRMInterface< GUM_SCALAR >::isSubTypeOf ( const PRMClassElementContainer< GUM_SCALAR > & cec ) const

virtual

Test if this PRMInterface is a sub PRMInterface of cec.

PRMInterface can not be a sub PRMInterface of a Class<GUM_SCALAR>, so if cec is a Class<GUM_SCALAR> this method will return false.

If cec is an PRMInterface then this PRMInterface is a sub PRMInterface of cec if they are equal or there exists a super PRMInterface of this PRMInterface which is equal to cec.

Parameters

cec	The PRMClassElementContainer<GUM_SCALAR> for which we determine if this PRMInterface is a sub PRMInterface of it.

Returns: Returns true if this Class<GUM_SCALAR> is a subclass of cec.

Implements gum::prm::PRMClassElementContainer< GUM_SCALAR >.

Definition at line 302 of file PRMInterface_tpl.h.

                                                                 {
       switch (cec.obj_type()) {
         case PRMClassElement< GUM_SCALAR >::prm_type::CLASS: {
           return false;
         }
 
         case PRMClassElement< GUM_SCALAR >::prm_type::PRM_INTERFACE: {
           const PRMInterface* current = this;
 
           while (current != 0) {
             if (current == &(cec)) return true;
 
             current = current->superInterface__;
           }
 
           return false;
         }
 
         default: {
           GUM_ERROR(FatalError, "unknown ClassElementContainer<GUM_SCALAR>");
         }
       }
     }

◆ isSuperTypeOf()

template<typename GUM_SCALAR>

INLINE bool gum::prm::PRMClassElementContainer< GUM_SCALAR >::isSuperTypeOf ( const PRMClassElementContainer< GUM_SCALAR > & cec ) const

virtualinherited

Test if this PRMClassElementContainer is a super type of cec.

This returns cec.isSubTypeOf(*this).

Parameters

cec

Returns: return true if this PRMClassElementContainer is a super type of cec.

Definition at line 125 of file PRMClassElementContainer_tpl.h.

                                                                 {
       return cec.isSubTypeOf(*this);
     }

◆ LEFT_CAST()

static std::string gum::prm::PRMObject::LEFT_CAST ( )

inlinestaticinherited

Enumeration of the different types of objects handled by a PRM.

The "all" type is used to tell that we want any kind of PRMType (useful with iterators for example). No PRMObject will ever have "all" as type.

Definition at line 79 of file PRMObject.h.

79 { return "("; }

◆ name() [1/2]

INLINE const std::string & gum::prm::PRMObject::name ( ) const

inherited

Returns the name of this object.

Definition at line 34 of file PRMObject_inl.h.

References gum::prm::ParamScopeData< GUM_SCALAR >::ParamScopeData().

34 { return name__; }

gum::prm::PRMObject::name__

std::string name__

Definition: PRMObject.h:207

Here is the call graph for this function:

◆ name() [2/2]

INLINE void gum::prm::PRMObject::name ( const std::string & name )

inherited

Change the name of the PRM Object.

Warning: Don't do this unless you know what you are doing !

Definition at line 38 of file PRMObject_inl.h.

References gum::prm::ParamScopeData< GUM_SCALAR >::ParamScopeData().

38 { name__ = name; }

gum::prm::PRMObject::name__

std::string name__

Definition: PRMObject.h:207

gum::prm::PRMObject::name

const std::string & name() const

Returns the name of this object.

Definition: PRMObject_inl.h:34

Here is the call graph for this function:

◆ obj_type()

template<typename GUM_SCALAR >

INLINE PRMObject::prm_type gum::prm::PRMInterface< GUM_SCALAR >::obj_type ( ) const

virtual

Implementation of pure virtual method of PRMObject.

Implements gum::prm::PRMObject.

Definition at line 427 of file PRMInterface_tpl.h.

                                                   {
       return PRMObject::prm_type::PRM_INTERFACE;
     }

◆ operator!=()

INLINE bool gum::prm::PRMObject::operator!= ( const PRMObject & obj ) const

inherited

To PRMObject are equal if they have the same name (which is unique).

Definition at line 48 of file PRMObject_inl.h.

References gum::prm::ParamScopeData< GUM_SCALAR >::ParamScopeData().

                                                          {
       return name__ != obj.name();
     }

Here is the call graph for this function:

◆ operator=()

template<typename GUM_SCALAR>

PRMInterface< GUM_SCALAR >& gum::prm::PRMInterface< GUM_SCALAR >::operator= ( const PRMInterface< GUM_SCALAR > & source )

private

Copy operator. Don't use it.

◆ operator==()

INLINE bool gum::prm::PRMObject::operator== ( const PRMObject & obj ) const

inherited

To PRMObject are equal if they have the same name (which is unique).

Definition at line 42 of file PRMObject_inl.h.

References gum::prm::ParamScopeData< GUM_SCALAR >::ParamScopeData().

                                                          {
       return name__ == obj.name();
     }

Here is the call graph for this function:

◆ operator[]() [1/4]

template<typename GUM_SCALAR >

INLINE PRMClassElement< GUM_SCALAR > & gum::prm::PRMInterface< GUM_SCALAR >::operator[] ( NodeId id )

virtual

See gum::prm::PRMClassElementContainer<GUM_SCALAR>::operator[](NodeId).

Implements gum::prm::PRMClassElementContainer< GUM_SCALAR >.

Definition at line 403 of file PRMInterface_tpl.h.

                                                        {
       return get(id);
     }

◆ operator[]() [2/4]

template<typename GUM_SCALAR >

INLINE const PRMClassElement< GUM_SCALAR > & gum::prm::PRMInterface< GUM_SCALAR >::operator[] ( NodeId id ) const

virtual

See gum::prm::PRMClassElementContainer<GUM_SCALAR>::operator[](NodeId).

Implements gum::prm::PRMClassElementContainer< GUM_SCALAR >.

Definition at line 409 of file PRMInterface_tpl.h.

                                                              {
       return get(id);
     }

◆ operator[]() [3/4]

template<typename GUM_SCALAR >

INLINE PRMClassElement< GUM_SCALAR > & gum::prm::PRMInterface< GUM_SCALAR >::operator[] ( const std::string & name )

virtual

See gum::prm::PRMClassElementContainer<GUM_SCALAR>::operator[](const std::string&).

Implements gum::prm::PRMClassElementContainer< GUM_SCALAR >.

Definition at line 415 of file PRMInterface_tpl.h.

                                                                    {
       return get(name);
     }

◆ operator[]() [4/4]

template<typename GUM_SCALAR >

INLINE const PRMClassElement< GUM_SCALAR > & gum::prm::PRMInterface< GUM_SCALAR >::operator[] ( const std::string & name ) const

virtual

See gum::prm::PRMClassElementContainer<GUM_SCALAR>::operator[](const std::string&).

Implements gum::prm::PRMClassElementContainer< GUM_SCALAR >.

Definition at line 421 of file PRMInterface_tpl.h.

                                                                          {
       return get(name);
     }

◆ overload()

template<typename GUM_SCALAR>

NodeId gum::prm::PRMInterface< GUM_SCALAR >::overload ( PRMClassElement< GUM_SCALAR > * elt )

virtual

Add a new PRMClassElement<GUM_SCALAR> which overload an inherited PRMClassElement<GUM_SCALAR>.

The pointer is "given" to this class, which will delete it when ~Class<GUM_SCALAR>() is called.

The NodeId of elt is defined when it is added to this, discarding any previous value. There is no garanty that elt will have the same NodeId than the PRMClassElement<GUM_SCALAR> it overloaded.

You can only overload inherited PRMClassElement<GUM_SCALAR> and only if elt is a subtype of the inherited PRMClassElement<GUM_SCALAR>. You do not define dependencies in an PRMInterface so it is useless to overload an PRMAttribute<GUM_SCALAR> with another sharing the same type, and if tried it will raise an OperationNotAllowed exception.

Parameters

elt	The new PRMClassElement<GUM_SCALAR> overloading an inherited PRMClassElement<GUM_SCALAR> in this.

Returns: the NodeId assigned to elt.

Exceptions

NotFound	Raised if no overloaded PRMClassElement<GUM_SCALAR> is found.
OperationNotAllowed	Raised if the overloading is impossible.

Implements gum::prm::PRMClassElementContainer< GUM_SCALAR >.

Definition at line 157 of file PRMInterface_tpl.h.

                                                   {
       try {
         if (!super().exists(overloader->name())) {
           GUM_ERROR(OperationNotAllowed,
                     "found no ClassElement<GUM_SCALAR> to overload");
         }
       } catch (NotFound&) {
         GUM_ERROR(OperationNotAllowed,
                   "overload is possible only with sub interfaces");
       }
 
       PRMClassElement< GUM_SCALAR >* overloaded = nameMap__[overloader->name()];
       if (overloaded == overloader) {
         GUM_ERROR(DuplicateElement,
                   "duplicate ClassElement '" << overloader->name() << "'");
       }
       if (!checkOverloadLegality__(overloaded, overloader)) {
         GUM_ERROR(OperationNotAllowed, "illegal overload");
       }
 
       switch (overloader->elt_type()) {
         case PRMClassElement< GUM_SCALAR >::prm_attribute: {
           auto attr_overloader
              = static_cast< PRMAttribute< GUM_SCALAR >* >(overloader);
           auto attr_overloaded
              = static_cast< PRMAttribute< GUM_SCALAR >* >(overloaded);
           overloadAttribute__(attr_overloader, attr_overloaded);
           break;
         }
 
         case PRMClassElement< GUM_SCALAR >::prm_refslot: {
           auto ref_overloader
              = static_cast< PRMReferenceSlot< GUM_SCALAR >* >(overloader);
           auto ref_overloaded
              = static_cast< PRMReferenceSlot< GUM_SCALAR >* >(overloaded);
           overloadReferenceSlot__(ref_overloader, ref_overloaded);
           break;
         }
 
         case PRMClassElement< GUM_SCALAR >::prm_aggregate:
         case PRMClassElement< GUM_SCALAR >::prm_slotchain: {
           auto msg = "element can ! be overloaded";
           GUM_ERROR(OperationNotAllowed, msg);
           break;
         }
 
         default: {
           GUM_ERROR(FatalError, "unknown ClassElement<GUM_SCALAR> type");
         }
       }
 
       return overloader->id();
     }

◆ overloadAttribute__()

template<typename GUM_SCALAR>

void gum::prm::PRMInterface< GUM_SCALAR >::overloadAttribute__	(	PRMAttribute< GUM_SCALAR > *	overloader,
		PRMAttribute< GUM_SCALAR > *	overloaded
	)

private

The alternate PRMClassElementContainer<GUM_SCALAR> searched for elements defined in this. Note that this is first searched for gum::PRMClassElement<GUM_SCALAR>.

Definition at line 213 of file PRMInterface_tpl.h.

                                                {
       if (overloader->type() != overloaded->type()) {
         overloader->setId(nextNodeId());
         dag__.addNodeWithId(overloader->id());
         nodeIdMap__.insert(overloader->id(), overloader);
         nameMap__[overloader->name()] = overloader;
         nameMap__.insert(overloader->safeName(), overloader);
         attributes__.insert(overloader);
         addCastDescendants__(overloader, overloaded);
       } else {
         overloader->setId(overloaded->id());
         nodeIdMap__[overloader->id()]     = overloader;
         nameMap__[overloader->name()]     = overloader;
         nameMap__[overloader->safeName()] = overloader;
         attributes__.erase(overloaded);
         attributes__.insert(overloader);
         // Swapping types, ugly but necessary to preserve the
         // PRMType<GUM_SCALAR>
         // pointer of overloaded
         overloader->overload(overloaded);
         delete overloaded;
       }
     }

◆ overloadReferenceSlot__()

template<typename GUM_SCALAR>

void gum::prm::PRMInterface< GUM_SCALAR >::overloadReferenceSlot__	(	PRMReferenceSlot< GUM_SCALAR > *	overloader,
		PRMReferenceSlot< GUM_SCALAR > *	overloaded
	)

private

The alternate PRMClassElementContainer<GUM_SCALAR> searched for elements defined in this. Note that this is first searched for gum::PRMClassElement<GUM_SCALAR>.

Definition at line 240 of file PRMInterface_tpl.h.

                                                    {
       // Adding overloading reference
       overloader->setId(overloaded->id());
       nodeIdMap__[overloader->id()] = overloader;
       nameMap__[overloader->name()] = overloader;
       nameMap__.insert(overloader->safeName(), overloader);
       referenceSlots__.insert(overloader);
       // Removing overloaded PRMReferenceSlot<GUM_SCALAR>
       referenceSlots__.erase(overloaded);
       nameMap__.erase(overloaded->safeName());
       delete overloaded;
     }

◆ referenceSlots()

template<typename GUM_SCALAR >

INLINE const Set< PRMReferenceSlot< GUM_SCALAR > *> & gum::prm::PRMInterface< GUM_SCALAR >::referenceSlots ( ) const

Returns the set of PRMAggregate of this Class<GUM_SCALAR>.

Returns: Returns the set of PRMAggregate of this Class<GUM_SCALAR>.

Definition at line 489 of file PRMInterface_tpl.h.

                                                                   {
       return referenceSlots__;
     }

◆ RIGHT_CAST()

static std::string gum::prm::PRMObject::RIGHT_CAST ( )

inlinestaticinherited

Enumeration of the different types of objects handled by a PRM.

The "all" type is used to tell that we want any kind of PRMType (useful with iterators for example). No PRMObject will ever have "all" as type.

Definition at line 80 of file PRMObject.h.

80 { return ")"; }

◆ setInputNode()

template<typename GUM_SCALAR>

INLINE void gum::prm::PRMClassElementContainer< GUM_SCALAR >::setInputNode	(	const PRMClassElement< GUM_SCALAR > &	elt,
		bool	b
	)

virtualinherited

Set the input flag value of id at b.

PRMAttribute or PRMAggregate can either be input, output, both or internal nodes.

By defaut, attributes and aggregates are inner nodes.

Parameters

elt	A PRMClassElement<GUM_SCALAR>.
b	The flag value.

Exceptions

NotFound	Raised if id does'nt match any PRMClassElement<GUM_SCALAR> in this.
WrongClassElement	Raised if NodeId is neither an PRMAttribute nor an PRMAggregate.

Definition at line 79 of file PRMClassElementContainer_tpl.h.

                                                {
       if (!exists(elt.safeName())) {
         GUM_ERROR(NotFound,
                   ": <" + elt.safeName() + "> is not in <" + name() + ">");
       } else if (PRMClassElement< GUM_SCALAR >::isAttribute(elt)
                  || PRMClassElement< GUM_SCALAR >::isAggregate(elt)) {
         try {
           getIOFlag_(elt).first = b;
         } catch (NotFound&) { setIOFlag_(elt, std::make_pair(b, false)); }
       } else {
         GUM_ERROR(WrongClassElement,
                   "given id is not an PRMAttribute or an PRMAggregate");
       }
     }

◆ setIOFlag_()

template<typename GUM_SCALAR>

INLINE void gum::prm::PRMClassElementContainer< GUM_SCALAR >::setIOFlag_	(	const PRMClassElement< GUM_SCALAR > &	elt,
		const std::pair< bool, bool > &	flags
	)

protectedvirtualinherited

Defines the IO flags of a PRMClassElement<GUM_SCALAR>.

Parameters

elt	The PRMClassElement<GUM_SCALAR>.
flags	The IO flags of elt. Overwrite any existing flags.

Returns: elt's IO flags.

Exceptions

NotFound Raised if elt does not have any IO flags.

Definition at line 155 of file PRMClassElementContainer_tpl.h.

                                                  {
       try {
         IOFlags__[elt.safeName()] = flags;
       } catch (NotFound&) { IOFlags__.insert(elt.safeName(), flags); }
     }

◆ setOutputNode()

template<typename GUM_SCALAR>

INLINE void gum::prm::PRMClassElementContainer< GUM_SCALAR >::setOutputNode	(	const PRMClassElement< GUM_SCALAR > &	elt,
		bool	b
	)

virtualinherited

Set the output flag value of id at b.

PRMAttribute or PRMAggregate can either be input, output, both or internal nodes.

By defaut, attributes and aggregates are inner nodes.

Parameters

elt	A PRMClassElement<GUM_SCALAR>.
b	The flag value.

Exceptions

NotFound	Raised if id does'nt match any PRMClassElement<GUM_SCALAR> in this.
WrongClassElement	Raised if NodeId is neither an PRMAttribute nor an PRMAggregate.

Definition at line 97 of file PRMClassElementContainer_tpl.h.

                                                {
       if (!exists(elt.safeName())) {
         GUM_ERROR(NotFound, "<" + elt.safeName() + "> is not in <" + name() + ">");
       } else if (PRMClassElement< GUM_SCALAR >::isAttribute(elt)
                  || PRMClassElement< GUM_SCALAR >::isAggregate(elt)) {
         try {
           getIOFlag_(elt).second = b;
         } catch (NotFound&) { setIOFlag_(elt, std::make_pair(false, b)); }
 
         if (b) { updateDescendants_(elt); }
       } else {
         GUM_ERROR(WrongClassElement,
                   "given ClassElement<GUM_SCALAR> is not an "
                   "PRMAttribute or an PRMAggregate");
       }
     }

◆ super() [1/2]

template<typename GUM_SCALAR >

INLINE PRMInterface< GUM_SCALAR > & gum::prm::PRMInterface< GUM_SCALAR >::super ( )

Returns the superInterface of this PRMInterface.

Returns: Returns the super PRMInterface of this PRMInterface.

Exceptions

NotFound Raised if this has no super PRMInterface.

Definition at line 373 of file PRMInterface_tpl.h.

                                                                          {
       if (superInterface__)
         return *superInterface__;
       else
         GUM_ERROR(NotFound, "this Interface is ! a sub interface");
     }

◆ super() [2/2]

template<typename GUM_SCALAR >

INLINE const PRMInterface< GUM_SCALAR > & gum::prm::PRMInterface< GUM_SCALAR >::super ( ) const

Returns the superInterface of this PRMInterface.

Returns: Returns the super PRMInterface of this PRMInterface.

Exceptions

NotFound Raised if this has no super PRMInterface.

Definition at line 382 of file PRMInterface_tpl.h.

                                                          {
       if (superInterface__)
         return *superInterface__;
       else
         GUM_ERROR(NotFound, "this Interface is ! a sub interface");
     }

◆ updateDescendants_()

template<typename GUM_SCALAR>

void gum::prm::PRMInterface< GUM_SCALAR >::updateDescendants_ ( const PRMClassElement< GUM_SCALAR > & elt )

protectedvirtual

See gum::prm::PRMClassElementContainer<GUM_SCALAR>(const PRMClassElement<GUM_SCALAR>&).

Implements gum::prm::PRMClassElementContainer< GUM_SCALAR >.

Definition at line 328 of file PRMInterface_tpl.h.

                                                  {
       // for ( const auto ext : extensions__ )
       //  if ( !ext->isOutputNode( elt ) ) ext->setOutputNode( elt, true );
 
       // for ( const auto impl : implementations__ ) {
       //  // Because of cyclic dependencies we must use a reinterpret cast.
       //  PRMClassElementContainer<GUM_SCALAR>* c =
       //      reinterpret_cast<PRMClassElementContainer<GUM_SCALAR>*>( impl );
 
       //  if ( ! c->isOutputNode( elt ) ) c->setOutputNode( elt, true );
       //}
     }

Definition at line 358 of file PRMInterface.h.

The documentation for this class was generated from the following files:

agrum/PRM/elements/PRMClass.h
agrum/PRM/elements/PRMInterface.h
agrum/PRM/elements/PRMInterface_tpl.h

Public Member Functions

Protected Member Functions

Friends

Iterators

Inheritance members

Built-in types.

Detailed Description

template<typename GUM_SCALAR> class gum::prm::PRMInterface< GUM_SCALAR >

Member Typedef Documentation

◆ ClassEltIterator

◆ const_ClassEltIterator

Member Enumeration Documentation

◆ prm_type

Constructor & Destructor Documentation

◆ PRMInterface() [1/3]

◆ PRMInterface() [2/3]

◆ PRMInterface() [3/3]

◆ ~PRMInterface()

Member Function Documentation

◆ add()

◆ addArc()

◆ addCastDescendants__()

◆ addExtension__()

◆ addImplementation__()

◆ attributes()

◆ begin() [1/2]

◆ begin() [2/2]

◆ belongsTo()

◆ checkOverloadLegality__()

◆ containerDag()

◆ copyIOFlags_()

◆ dag_() [1/2]

◆ dag_() [2/2]

◆ end() [1/2]

◆ end() [2/2]

◆ enum2str()

◆ exists() [1/2]

◆ exists() [2/2]

◆ findAllSubtypes_()

◆ get() [1/4]

◆ get() [2/4]

◆ get() [3/4]

◆ get() [4/4]

◆ getIOFlag_() [1/2]

◆ getIOFlag_() [2/2]

◆ implementations() [1/2]

◆ implementations() [2/2]

◆ inheritInterface()

◆ inheritInterface__()

◆ isClass()

◆ isInnerNode()

◆ isInputNode()

◆ isInstance()

◆ isInterface()

◆ isOutputNode()

◆ isSubTypeOf()

◆ isSuperTypeOf()

◆ LEFT_CAST()

◆ name() [1/2]

◆ name() [2/2]

◆ obj_type()

◆ operator!=()

◆ operator=()

◆ operator==()

◆ operator[]() [1/4]

◆ operator[]() [2/4]

◆ operator[]() [3/4]

◆ operator[]() [4/4]

◆ overload()

◆ overloadAttribute__()

◆ overloadReferenceSlot__()

◆ referenceSlots()

◆ RIGHT_CAST()

◆ setInputNode()

◆ setIOFlag_()

◆ setOutputNode()

◆ super() [1/2]

◆ super() [2/2]

◆ updateDescendants_()

Friends And Related Function Documentation

template<typename GUM_SCALAR>
class gum::prm::PRMInterface< GUM_SCALAR >