A property represents a named value of any type with a description. More...

#include <rtt/Property.hpp>

Inheritance diagram for RTT::Property< T >:

Public Types
typedef boost::remove_const < typename boost::remove_reference< T > ::type >::type	value_t
	The types of this property type.
typedef boost::call_traits < value_t >::param_type	param_t
typedef boost::call_traits < value_t >::reference	reference_t
typedef boost::call_traits < value_t >::const_reference	const_reference_t
typedef value_t	DataSourceType
Public Member Functions
	Property ()
	Create an empty Property with no name, no description and no value.
	Property (const std::string &name)
	The constructor which initializes the property's value to the default.
	Property (const std::string &name, const std::string &description, param_t value=value_t())
	The constructor which initializes the property's value.
	Property (const Property< T > &orig)
	Copy constructors copies the name, description and value as deep copies.
	Property (base::PropertyBase *source)
	Create a Property mirroring another PropertyBase.
	Property (const std::string &name, const std::string &description, typename internal::AssignableDataSource< DataSourceType >::shared_ptr datasource)
	The constructor which initializes the property with a DataSource.
Property< T > &	operator= (param_t value)
	Set the property's value.
Property< T > &	operator= (base::PropertyBase *source)
	Construct a Property which mirrors a PropertyBase.
Property< T > &	operator<<= (Property< T > &p)
	Update the value of this property with another property.
Property< T > &	doc (const std::string &descr)
	Documents this property.
	operator value_t () const
	Get a copy of the value of the property.
DataSourceType	get () const
	Get a copy of the value of the property.
reference_t	set ()
	Access to the value of the Property.
void	set (param_t v)
	Set the value of the Property.
reference_t	value ()
	Access to the value of the Property.
const_reference_t	rvalue () const
	Read-only (const&) access to the value of the Property.
virtual void	identify (base::PropertyIntrospection *pi)
	A call on this method will lead to a call to the PropertyIntrospection interface identifying this Property's proper type.
virtual void	identify (base::PropertyBagVisitor *pi)
	A call on this method will lead to a call to the PropertyBagIntrospection interface identifying this Property's proper type.
virtual bool	update (const base::PropertyBase *other)
	Update the value of this Property with the value of an other Property.
virtual bool	refresh (const base::PropertyBase *other)
	Refresh the value of this Property with the value of an other Property.
virtual bool	copy (const base::PropertyBase *other)
	Copy an other Property onto this property.
bool	copy (const Property< T > &orig)
	Copy the value, complete overwrite of this Property with orig.
bool	update (const Property< T > &orig)
	Update the value, optionally also the description if current description is empty.
bool	refresh (const Property< T > &orig)
	Refresh only the value from a Property.
virtual Property< T > *	clone () const
	Deliver an identical clone of this PropertyBase.
virtual Property< T > *	create () const
	Create a new default instance of the PropertyBase.
virtual base::DataSourceBase::shared_ptr	getDataSource () const
	Get a internal::DataSource through which this PropertyBase can be manipulated.
internal::AssignableDataSource < DataSourceType >::shared_ptr	getAssignableDataSource () const
virtual std::string	getType () const
	Returns the type of this PropertyBase.
virtual const types::TypeInfo *	getTypeInfo () const
	Returns the types::TypeInfo object of this Property.
template<>
void	identify (PropertyBagVisitor *pbi)
	A call on this method will lead to a call to the PropertyBagIntrospection interface identifying this Property's proper type.
template<>
RTT_API bool	update (const Property< PropertyBag > &orig)
template<>
RTT_API bool	refresh (const Property< PropertyBag > &orig)
template<>
RTT_API bool	copy (const Property< PropertyBag > &orig)
template<>
RTT_API void	identify (base::PropertyBagVisitor *pbi)
	A call on this method will lead to a call to the PropertyBagIntrospection interface identifying this Property's proper type.
template<>
bool	update (const Property< PropertyBag > &orig)
template<>
bool	refresh (const Property< PropertyBag > &orig)
template<>
bool	copy (const Property< PropertyBag > &orig)
const std::string &	getName () const
	Get the name of the property.
void	setName (const std::string &name)
	Set the name of the property.
const std::string &	getDescription () const
	Get a description of the property.
void	setDescription (const std::string &desc)
	Set the description of the property.
bool	ready () const
	Inspect if this Property is correctly initialised and ready for usage.
virtual bool	compose (const PropertyBag &source)
	Composes the data of this property with information found in a PropertyBag.
Static Public Member Functions
static Property< T > *	narrow (base::PropertyBase *prop)
	Use this method instead of dynamic_cast<> to cast from base::PropertyBase to Property<T>.
Protected Attributes
internal::AssignableDataSource < DataSourceType >::shared_ptr	_value
std::string	_name
	A short name for this PropertyBase.
std::string	_description
	A lengthy description for this PropertyBase.

Detailed Description

template<typename T>
class RTT::Property< T >

A property represents a named value of any type with a description.

A property is a tuple of a name, a description and a variable of any type. It's purpose is to provide a hierarchical parameter of a component. They are grouped in PropertyBag objects and a Property can contain a PropertyBag itself.

If you do not provide a name nor description when constructing the Property object, it will be uninitialised and ready() will return false. Such an object may not be used (set(), get(),...) until it has been initialised from another Property. Otherwise, an exception (or assert) will be thrown.

Parameters:

T	The type of the data contained within the Property.

Definition at line 76 of file Property.hpp.

Member Typedef Documentation

template<typename T>

typedef boost::remove_const<typename boost::remove_reference<T>::type>::type RTT::Property< T >::value_t

The types of this property type.

value_t is always the 'bare' value type of T. From this type, we derive the other (param, ref, ...) types.

Definition at line 85 of file Property.hpp.

Constructor & Destructor Documentation

template<typename T>

RTT::Property< T >::Property ( ) [inline]

Create an empty Property with no name, no description and no value.

Postcondition:: ready() will return false. Initialise this Property with another Property object.

Definition at line 95 of file Property.hpp.

template<typename T>

RTT::Property< T >::Property ( const std::string & name ) [inline, explicit]

The constructor which initializes the property's value to the default.

Parameters:

name	The name which will be used to refer to the property.

Postcondition:: ready() will always be true.

Definition at line 104 of file Property.hpp.

template<typename T>

RTT::Property< T >::Property	(	const std::string &	name,
		const std::string &	description,
		param_t	value = `value_t()`
	)		`[inline]`

The constructor which initializes the property's value.

Parameters:

name	The name which will be used to refer to the property.
description	The description of the property.
value	The initial value of the property (optional).

Postcondition:: ready() will always be true.

Definition at line 117 of file Property.hpp.

template<typename T>

RTT::Property< T >::Property ( const Property< T > & orig ) [inline]

Copy constructors copies the name, description and value as deep copies.

Postcondition:: ready() will be true if orig.ready() is true.

Definition at line 127 of file Property.hpp.

template<typename T>

RTT::Property< T >::Property ( base::PropertyBase * source ) [inline]

Create a Property mirroring another PropertyBase.

It copies the name and description, and shallow copies the value.

See also:: ready() to inspect if the creation succeeded.

Definition at line 142 of file Property.hpp.

template<typename T>

RTT::Property< T >::Property	(	const std::string &	name,
		const std::string &	description,
		typename internal::AssignableDataSource< DataSourceType >::shared_ptr	datasource
	)		`[inline]`

The constructor which initializes the property with a DataSource.

Parameters:

name	The name which will be used to refer to the property.
description	The description of the property.
datasource	A new data source to be acquired by this property for storing its data.

Postcondition:: ready() will be true if datasource is a valid pointer.

Definition at line 164 of file Property.hpp.

Member Function Documentation

template<typename T>

virtual Property<T>* RTT::Property< T >::clone ( ) const [inline, virtual]

Deliver an identical clone of this PropertyBase.

The original may be deleted and the clone can be transparantly used in its place or vice versa.

Implements RTT::base::PropertyBase.

Definition at line 368 of file Property.hpp.

bool RTT::PropertyBase::compose ( const PropertyBag & source ) [virtual, inherited]

Composes the data of this property with information found in a PropertyBag.

This only works for data types that defined a compose/decompose function in their type info structure.

Definition at line 80 of file PropertyBase.cpp.

References RTT::base::PropertyBase::getDataSource(), and RTT::base::DataSourceBase::ref().

template<typename T>

virtual bool RTT::Property< T >::copy ( const base::PropertyBase * other ) [inline, virtual]

Copy an other Property onto this property.

Copy does a full update of the name, description and value, adding extra information if necessary, or in case of a Property<PropertyBag> adding all Properties.

Copy only works on properties that are ready() and both have the same data type T.

Returns:: false if the Properties are of different type.

Implements RTT::base::PropertyBase.

Definition at line 320 of file Property.hpp.

Referenced by RTT::Property< bool >::copy().

template<typename T>

virtual Property<T>* RTT::Property< T >::create ( ) const [inline, virtual]

Create a new default instance of the PropertyBase.

This is a factory method to 'make something of the same type'. The new PropertyBase has the same name and description as this.

Implements RTT::base::PropertyBase.

Definition at line 373 of file Property.hpp.

template<typename T>

Property<T>& RTT::Property< T >::doc ( const std::string & descr ) [inline]

Documents this property.

Parameters:

descr The description of this property

Returns:: A reference to this object.

Definition at line 225 of file Property.hpp.

template<typename T>

DataSourceType RTT::Property< T >::get ( ) const [inline]

Get a copy of the value of the property.

Returns:: The value of the property.

Definition at line 243 of file Property.hpp.

Referenced by RTT::types::composeProperty(), RTT::extras::composeProperty(), RTT::extras::decomposeProperty(), RTT::scripting::ConditionBoolProperty::evaluate(), and RTT::marsh::PropertyBagIntrospector::introspect().

const std::string& RTT::base::PropertyBase::getDescription ( ) const [inline, inherited]

Get a description of the property.

Returns:: description of the property.

Definition at line 94 of file PropertyBase.hpp.

Referenced by RTT::types::composePropertyBag(), RTT::Property< bool >::copy(), RTT::types::decomposePropertyBag(), RTT::marsh::PropertyBagIntrospector::introspect(), RTT::base::PropertyBagVisitor::introspectAndDecompose(), RTT::Property< bool >::operator=(), RTT::Property< bool >::update(), and RTT::updateProperties().

const std::string& RTT::base::PropertyBase::getName ( ) const [inline, inherited]

Get the name of the property.

Returns:: name of the property.

Definition at line 82 of file PropertyBase.hpp.

Referenced by RTT::ConfigurationInterface::addProperty(), RTT::types::composeProperty(), RTT::types::composePropertyBag(), RTT::Property< bool >::copy(), RTT::types::decomposePropertyBag(), RTT::flattenPropertyBag(), RTT::marsh::PropertyBagIntrospector::introspect(), RTT::base::PropertyBagVisitor::introspectAndDecompose(), RTT::operator<<(), RTT::Property< bool >::operator=(), RTT::Property< bool >::Property(), RTT::refreshProperties(), RTT::refreshProperty(), RTT::ConfigurationInterface::removeProperty(), RTT::updateProperties(), and RTT::updateProperty().

template<typename T>

virtual std::string RTT::Property< T >::getType ( ) const [inline, virtual]

Returns the type of this PropertyBase.

Uses the naming scheme of DataSourceTypeInfo.

Implements RTT::base::PropertyBase.

Definition at line 386 of file Property.hpp.

Referenced by RTT::Property< bool >::Property().

template<>

void RTT::Property< PropertyBag >::identify ( PropertyBagVisitor * pi ) [virtual]

A call on this method will lead to a call to the PropertyBagIntrospection interface identifying this Property's proper type.

Deprecated:: DO NOT USE. Will be removed in 2.x release series.

Reimplemented from RTT::base::PropertyBase.

Definition at line 53 of file Property.cpp.

References RTT::base::PropertyBagVisitor::introspect().

template<class T >

void RTT::Property< T >::identify ( base::PropertyIntrospection * pi ) [virtual]

A call on this method will lead to a call to the PropertyIntrospection interface identifying this Property's proper type.

Deprecated:: DO NOT USE. Will be removed in 2.x release series.

Implements RTT::base::PropertyBase.

Definition at line 431 of file Property.hpp.

References RTT::base::PropertyIntrospection::introspect().

template<class T >

void RTT::Property< T >::identify ( base::PropertyBagVisitor * pi ) [virtual]

A call on this method will lead to a call to the PropertyBagIntrospection interface identifying this Property's proper type.

Deprecated:: DO NOT USE. Will be removed in 2.x release series.

Reimplemented from RTT::base::PropertyBase.

Definition at line 437 of file Property.hpp.

References RTT::base::PropertyBase::identify().

template<>

RTT_API void RTT::Property< PropertyBag >::identify ( base::PropertyBagVisitor * pi ) [virtual]

A call on this method will lead to a call to the PropertyBagIntrospection interface identifying this Property's proper type.

Deprecated:: DO NOT USE. Will be removed in 2.x release series.

Reimplemented from RTT::base::PropertyBase.

template<class T >

Property< T > * RTT::Property< T >::narrow ( base::PropertyBase * prop ) [static]

Use this method instead of dynamic_cast<> to cast from base::PropertyBase to Property<T>.

You need to delete the returned property if it is no longer needed.

Parameters:

T	The Desired property type, for example 'double'.
prop	The property to narrow to Property<T>.

Returns:: Null if prop is not convertible to type Property<T>, a new Property<T> instance otherwise.

Definition at line 420 of file Property.hpp.

Referenced by RTT::Property< bool >::operator=().

template<typename T>

RTT::Property< T >::operator value_t ( ) const [inline]

Get a copy of the value of the property.

Returns:: A copy of the value of the property.

Definition at line 234 of file Property.hpp.

template<typename T>

Property<T>& RTT::Property< T >::operator= ( param_t value ) [inline]

Set the property's value.

Parameters:

value The value to be set.

Returns:: A reference to newly set property value.

Definition at line 178 of file Property.hpp.

template<typename T>

Property<T>& RTT::Property< T >::operator= ( base::PropertyBase * source ) [inline]

Construct a Property which mirrors a PropertyBase.

Parameters:

source A pointer to the property to mirror.

Definition at line 188 of file Property.hpp.

bool RTT::base::PropertyBase::ready ( ) const [inline, inherited]

Inspect if this Property is correctly initialised and ready for usage.

A Property may only be used when ready() returns true, otherwise, an exception is thrown.

Definition at line 108 of file PropertyBase.hpp.

Referenced by RTT::PropertyBag::addProperty(), RTT::ConfigurationInterface::addProperty(), RTT::types::composePropertyBag(), RTT::Property< bool >::copy(), RTT::types::decomposePropertyBag(), RTT::PropertyBag::findValue(), RTT::PropertyBag::ownProperty(), RTT::Property< bool >::refresh(), RTT::removeProperty(), and RTT::Property< bool >::update().

template<typename T>

virtual bool RTT::Property< T >::refresh ( const base::PropertyBase * other ) [inline, virtual]

Refresh the value of this Property with the value of an other Property.

Refresh does only the minimal update of the value, not adding extra information, or in case of a Property<PropertyBag> not adding extra Properties.

Refresh only works on properties that are ready() and both have the same data type T.

Returns:: false if the Properties are of different type.

Implements RTT::base::PropertyBase.

Definition at line 311 of file Property.hpp.

Referenced by RTT::Property< bool >::refresh().

template<typename T>

bool RTT::Property< T >::refresh ( const Property< T > & orig ) [inline]

Refresh only the value from a Property.

This is a real-time operation.

Definition at line 360 of file Property.hpp.

template<typename T>

reference_t RTT::Property< T >::set ( ) [inline]

Access to the value of the Property.

Identical to value().

Warning:: This function is not suitable for remote (distributed) access of properties, use operator=() or set( param_t v ) to assign a value.

Definition at line 254 of file Property.hpp.

void RTT::PropertyBase::setDescription ( const std::string & desc ) [inherited]

Set the description of the property.

Parameters:

desc	The description of the property.

Definition at line 64 of file PropertyBase.cpp.

References RTT::base::PropertyBase::_description.

Referenced by RTT::Property< bool >::doc(), and RTT::Property< bool >::operator=().

void RTT::PropertyBase::setName ( const std::string & name ) [inherited]

Set the name of the property.

Parameters:

name	The name of the property.

Definition at line 59 of file PropertyBase.cpp.

References RTT::base::PropertyBase::_name.

Referenced by RTT::ConfigurationInterface::addProperty(), and RTT::Property< bool >::operator=().

template<typename T>

virtual bool RTT::Property< T >::update ( const base::PropertyBase * other ) [inline, virtual]

Update the value of this Property with the value of an other Property.

Update does a full update of the value, adding extra information if necessary, or in case of a Property<PropertyBag> adding missing Properties.

Update only works on properties that are ready() and both have the same data type T.

Returns:: false if the Properties are of different type or if this->ready() == false.

Implements RTT::base::PropertyBase.

Definition at line 302 of file Property.hpp.

Referenced by RTT::Property< bool >::operator<<=(), and RTT::Property< bool >::update().

template<typename T>

reference_t RTT::Property< T >::value ( ) [inline]

Access to the value of the Property.

Identical to set().

Warning:: This function is not suitable for remote (distributed) access of properties, use operator=() or set( param_t v ) to assign a value.

Definition at line 274 of file Property.hpp.

Referenced by RTT::types::composePropertyBag(), RTT::extras::decomposeProperty(), RTT::types::decomposePropertyBag(), RTT::deletePropertyBag(), RTT::PropertyBag::findValue(), RTT::flattenPropertyBag(), RTT::marsh::PropertyBagIntrospector::introspect(), RTT::refreshProperty(), RTT::removeProperty(), RTT::storeProperty(), RTT::updateProperties(), and RTT::updateProperty().

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

rtt/Property.hpp

Public Types

Public Member Functions

Static Public Member Functions

Protected Attributes

Detailed Description

template<typename T> class RTT::Property< T >

Member Typedef Documentation

Constructor & Destructor Documentation

Member Function Documentation

template<typename T>
class RTT::Property< T >