Public Types | Public Member Functions | Protected Types | Protected Member Functions | Protected Attributes | List of all members

A class for keeping track of Attribute, Constant and Property objects of a TaskContext. It allows plugins and remote components to browse the attributes and properties of a TaskContext. More...

#include <ConfigurationInterface.hpp>

Inheritance diagram for RTT::ConfigurationInterface:
Inheritance graph
[legend]

Public Types

typedef std::vector< std::string > AttributeNames
 
typedef std::vector< base::AttributeBase * > AttributeObjects
 

Public Member Functions

template<class T >
bool addAttribute (const std::string &name, T &attr)
 
template<class T >
Attribute< T > & addAttribute (const std::string &name, Attribute< T > &attr)
 
bool addAttribute (base::AttributeBase &a)
 
template<class T >
bool addConstant (const std::string &name, const T &cnst)
 
template<class T >
Constant< T > & addConstant (const std::string &name, Constant< T > &cnst)
 
bool addConstant (base::AttributeBase &c)
 
template<class T >
Property< T > & addProperty (const std::string &name, T &prop)
 
template<class T >
Property< T > & addProperty (const std::string &name, Property< T > &prop)
 
bool addProperty (base::PropertyBase &pb)
 
void clear ()
 
 ConfigurationInterface ()
 
ConfigurationInterfacecopy (std::map< const base::DataSourceBase *, base::DataSourceBase * > &repl, bool instantiate) const
 
base::AttributeBasegetAttribute (const std::string &name) const
 
AttributeNames getAttributeNames () const
 
base::AttributeBasegetConstant (const std::string &name) const
 
base::PropertyBasegetProperty (const std::string &name) const
 
base::AttributeBasegetValue (const std::string &name) const
 
AttributeObjects const & getValues () const
 
bool hasAttribute (const std::string &name) const
 
bool hasProperty (const std::string &name) const
 
void loadValues (AttributeObjects const &new_values)
 
PropertyBagproperties ()
 
void removeAttribute (const std::string &name)
 
bool removeProperty (base::PropertyBase &p)
 
bool removeValue (const std::string &name)
 
bool setValue (base::AttributeBase *ab)
 
 ~ConfigurationInterface ()
 

Protected Types

typedef std::vector< base::AttributeBase * > map_t
 

Protected Member Functions

bool chkPtr (const std::string &where, const std::string &name, const void *ptr)
 

Protected Attributes

PropertyBag bag
 
map_t values
 

Detailed Description

A class for keeping track of Attribute, Constant and Property objects of a TaskContext. It allows plugins and remote components to browse the attributes and properties of a TaskContext.

Definition at line 60 of file ConfigurationInterface.hpp.

Member Typedef Documentation

typedef std::vector<std::string> RTT::ConfigurationInterface::AttributeNames

A vector containing the names of all attribute objects in this repository.

Definition at line 74 of file ConfigurationInterface.hpp.

A vector containing pointers to all attribute objects stored in this repository.

Definition at line 80 of file ConfigurationInterface.hpp.

Definition at line 336 of file ConfigurationInterface.hpp.

Constructor & Destructor Documentation

RTT::ConfigurationInterface::ConfigurationInterface ( )

Create an empty ConfigurationInterface.

Definition at line 50 of file ConfigurationInterface.cpp.

RTT::ConfigurationInterface::~ConfigurationInterface ( )

Definition at line 54 of file ConfigurationInterface.cpp.

Member Function Documentation

template<class T >
bool RTT::ConfigurationInterface::addAttribute ( const std::string &  name,
T &  attr 
)
inline

Adds a variable of any type as read/write attribute to the configuration interface. An Alias is created which causes contents of the attr variable always to be in sync with the contents of the attribute object in the interface.

Parameters
nameThe name of this attribute
attrThe variable that will be aliased.

Definition at line 101 of file ConfigurationInterface.hpp.

template<class T >
Attribute<T>& RTT::ConfigurationInterface::addAttribute ( const std::string &  name,
Attribute< T > &  attr 
)
inline

Adds an existing attribute object to the configuration interface.

Parameters
nameThe name of this attribute. attr will be initialized with this name.
attrThe attribute to add
Returns
the Attribute object by reference, which you can further query or use.
Postcondition
attr.ready() == true

Definition at line 115 of file ConfigurationInterface.hpp.

bool RTT::ConfigurationInterface::addAttribute ( base::AttributeBase a)
inline

Add an base::AttributeBase which remains owned by the user. This is a low-level function that can be used if you already created an Attribute object that does not belong yet to a service.

Parameters
aremains owned by the user, and becomes served by the repository.

Definition at line 204 of file ConfigurationInterface.hpp.

template<class T >
bool RTT::ConfigurationInterface::addConstant ( const std::string &  name,
const T &  cnst 
)
inline

Adds a variable of any type as read-only attribute to the configuration interface. An Alias is created which causes contents of the attribute always to be in sync with the contents of cnst, but it can only be read through the interface.

Parameters
nameThe name of this attribute
cnstThe variable that will be aliased.

Definition at line 135 of file ConfigurationInterface.hpp.

template<class T >
Constant<T>& RTT::ConfigurationInterface::addConstant ( const std::string &  name,
Constant< T > &  cnst 
)
inline

Adds an existing constant object to the configuration interface.

Parameters
nameThe name of this constant. cnst will be initialized with this name.
cnstThe constant to add. If cnst has not been initialized, it will be initialized to T(). You can change it later-on using the Constant's API.
Returns
the Constant object by reference, which you can further query or use.
Postcondition
cnst.ready() == true

Definition at line 150 of file ConfigurationInterface.hpp.

bool RTT::ConfigurationInterface::addConstant ( base::AttributeBase c)
inline

Add a Constant with a given value.

See also
getConstant

Definition at line 232 of file ConfigurationInterface.hpp.

template<class T >
Property<T>& RTT::ConfigurationInterface::addProperty ( const std::string &  name,
T &  prop 
)
inline

Adds a variable of any type as a property to the configuration interface. A Property is created which causes contents of the property always to be in sync with the contents of prop.

Parameters
nameThe name of this property
propThe variable that will be aliased.
Returns
the Property object by reference, which you can further query or document.

Definition at line 171 of file ConfigurationInterface.hpp.

template<class T >
Property<T>& RTT::ConfigurationInterface::addProperty ( const std::string &  name,
Property< T > &  prop 
)
inline

Adds an existing property object to the configuration interface.

Parameters
nameThe name of this property. prop will be initialized with this name.
propThe property to add
Returns
the Property object by reference, which you can further query or document.
Postcondition
prop.ready() == true

Definition at line 184 of file ConfigurationInterface.hpp.

bool RTT::ConfigurationInterface::addProperty ( base::PropertyBase pb)

Add an base::PropertyBase as a property.

Returns
false if a property with the same name already exists.
See also
removeProperty

Definition at line 90 of file ConfigurationInterface.cpp.

bool RTT::ConfigurationInterface::chkPtr ( const std::string &  where,
const std::string &  name,
const void *  ptr 
)
protected

Definition at line 156 of file ConfigurationInterface.cpp.

void RTT::ConfigurationInterface::clear ( )

Erases the whole repository.

Definition at line 70 of file ConfigurationInterface.cpp.

ConfigurationInterface * RTT::ConfigurationInterface::copy ( std::map< const base::DataSourceBase *, base::DataSourceBase * > &  repl,
bool  instantiate 
) const

Return a new copy of this repository with the copy operation semantics.

Parameters
instantiateset to true if you want a copy which will upon any future copy return the same DataSources, thus 'fixating' or 'instantiating' the DataSources.
See also
base::ActionInterface
Note
this does not copy the properties() within this repository.

Definition at line 60 of file ConfigurationInterface.cpp.

base::AttributeBase* RTT::ConfigurationInterface::getAttribute ( const std::string &  name) const
inline

Definition at line 218 of file ConfigurationInterface.hpp.

std::vector< std::string > RTT::ConfigurationInterface::getAttributeNames ( ) const

Return the names of all attributes in this repository.

Definition at line 138 of file ConfigurationInterface.cpp.

base::AttributeBase* RTT::ConfigurationInterface::getConstant ( const std::string &  name) const
inline

Definition at line 245 of file ConfigurationInterface.hpp.

base::PropertyBase* RTT::ConfigurationInterface::getProperty ( const std::string &  name) const
inline

Get a Property with name name.

Parameters
nameThe name of the property to search for.
Returns
The PropertyBase with this name, zero if it does not exist.

Definition at line 275 of file ConfigurationInterface.hpp.

AttributeBase * RTT::ConfigurationInterface::getValue ( const std::string &  name) const

Definition at line 111 of file ConfigurationInterface.cpp.

AttributeObjects const& RTT::ConfigurationInterface::getValues ( ) const
inline

Returns all attributes in this repository.

Definition at line 320 of file ConfigurationInterface.hpp.

bool RTT::ConfigurationInterface::hasAttribute ( const std::string &  name) const

Check if an attribute is present in this interface.

Definition at line 118 of file ConfigurationInterface.cpp.

bool RTT::ConfigurationInterface::hasProperty ( const std::string &  name) const

Check if a property is present.

Definition at line 124 of file ConfigurationInterface.cpp.

void RTT::ConfigurationInterface::loadValues ( AttributeObjects const &  new_values)

Adds these attributes to this repository.

Definition at line 145 of file ConfigurationInterface.cpp.

PropertyBag * RTT::ConfigurationInterface::properties ( )

Return a bag of all properties.

Definition at line 150 of file ConfigurationInterface.cpp.

void RTT::ConfigurationInterface::removeAttribute ( const std::string &  name)

Remove an attribute from the repository.

Definition at line 96 of file ConfigurationInterface.cpp.

bool RTT::ConfigurationInterface::removeProperty ( base::PropertyBase p)

Remove a previously added Property and associated attribute.

Returns
false if no such property exists.

Definition at line 129 of file ConfigurationInterface.cpp.

bool RTT::ConfigurationInterface::removeValue ( const std::string &  name)

Delete a value added with setValue from the repository.

Definition at line 100 of file ConfigurationInterface.cpp.

bool RTT::ConfigurationInterface::setValue ( base::AttributeBase ab)

Transfer the ownership of an attribute to the repository.

Parameters
abThe attribute which becomes owned by this repository.
Returns
false if an Attribute with the same name already present.

Definition at line 78 of file ConfigurationInterface.cpp.

Member Data Documentation

PropertyBag RTT::ConfigurationInterface::bag
protected

Definition at line 338 of file ConfigurationInterface.hpp.

map_t RTT::ConfigurationInterface::values
protected

Definition at line 337 of file ConfigurationInterface.hpp.


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


rtt
Author(s): RTT Developers
autogenerated on Fri Oct 25 2019 03:59:46