A DataSource which is used to mirror another datasource. More...

#include <rtt/internal/DataSources.hpp>

Inheritance diagram for RTT::internal::AliasDataSource< T >:

Public Types
typedef boost::intrusive_ptr< AliasDataSource< T > >	shared_ptr

typedef T	value_t
	The bare type of T is extracted into value_t. More...

typedef T	result_t

typedef details::GetConstRef< T >::type	const_reference_t

typedef boost::intrusive_ptr< const DataSource< T > >	const_ptr

Public Member Functions
	AliasDataSource (DataSource< T > *ds)

	~AliasDataSource ()

bool	evaluate () const
	Force an evaluation of the DataSourceBase. More...

DataSource< T >::result_t	get () const
	Return the data as type T. More...

DataSource< T >::result_t	value () const
	Return the result of the last evaluate() function. More...

DataSource< T >::const_reference_t	rvalue () const
	Get a const reference to the value of this DataSource. More...

virtual void	reset ()
	Reset the data to initial values. More...

virtual AliasDataSource< T > *	clone () const
	Return a shallow clone of this DataSource. More...

virtual AliasDataSource< T > *	copy (std::map< const base::DataSourceBase , base::DataSourceBase > &alreadyCloned) const
	Create a deep copy of this internal::DataSource, unless it is already cloned. More...

	BOOST_STATIC_ASSERT (!details::HasConst< T >::value)
	If you get a compile error here, it means T has const or reference qualifiers, which is not allowed for DataSource<T> More...

void const *	getRawConstPointer ()
	Generic implementation of getRawConstPointer() based on rvalue() More...

template<>
void const *	getRawConstPointer ()
	Returns a const pointer to the sample contained in this data source, if there is any. More...

virtual std::string	getType () const
	Return useful type info in a human readable format. More...

virtual const types::TypeInfo *	getTypeInfo () const
	Return the Orocos type info object. More...

virtual std::string	getTypeName () const
	Return the Orocos type name, without const, pointer or reference qualifiers. More...

void	ref () const
	Increase the reference count by one. More...

void	deref () const
	Decrease the reference count by one and delete this on zero. More...

virtual bool	isAssignable () const
	Returns true if this object can be cast to an AssignableDataSource. More...

virtual void	updated ()
	In case the internal::DataSource returns a 'reference' type, call this method to notify it that the data was updated in the course of an invocation of get(). More...

virtual bool	update (DataSourceBase *other)
	Update the value of this internal::DataSource with the value of an other DataSource. More...

virtual ActionInterface *	updateAction (DataSourceBase *other)
	Generate a ActionInterface object which will update this internal::DataSource with the value of another internal::DataSource when execute()'ed. More...

virtual shared_ptr	getMember (const std::string &member_name)
	Get a (const) reference data source to a member of the structure of this data source. More...

virtual shared_ptr	getMember (DataSourceBase::shared_ptr member_id, DataSourceBase::shared_ptr offset)
	Same as above, but with run-time lookup of the member to use. More...

virtual std::vector< std::string >	getMemberNames () const
	Returns the names of all members of the structure contained in this data source, or an empty list if none. More...

virtual shared_ptr	getParent ()
	Returns the top level data source that contains the full data structure this data source refers to. More...

std::ostream &	write (std::ostream &os)
	Stream the contents of this object. More...

std::string	toString ()
	Get the contents of this object as a string. More...

virtual void *	getRawPointer ()
	Returns a pointer to the sample contained in this data source, if there is any, and if it is an lvalue. More...

Static Public Member Functions
static std::string	GetType ()
	Return usefull type info in a human readable format. More...

static const types::TypeInfo *	GetTypeInfo ()
	Return the Orocos type info. More...

static std::string	GetTypeName ()
	Return the Orocos type name, without const, pointer or reference qualifiers. More...

static DataSource< T > *	narrow (base::DataSourceBase *db)
	This method narrows a base::DataSourceBase to a typeded DataSource, possibly returning a new object. More...

static shared_ptr	stack_shared_ptr (DataSourceBase *dsb)
	Returns a shared ptr to a DataSourceBase living on the stack. More...

static const_ptr	stack_const_ptr (const DataSourceBase *dsb)
	Returns a const shared_ptr to a DataSourceBase living on the stack. More...

Protected Attributes
os::AtomicInt	refcount
	We keep the refcount ourselves. More...

Detailed Description

template<typename T>
class RTT::internal::AliasDataSource< T >

A DataSource which is used to mirror another datasource.

Used to strip the 'assignable' property of a data source.

Parameters

T	The result data type of get().

Definition at line 263 of file DataSources.hpp.

Member Typedef Documentation

template<typename T>

typedef boost::intrusive_ptr<const DataSource<T> > RTT::internal::DataSource< T >::const_ptr

inherited

Definition at line 117 of file DataSource.hpp.

template<typename T>

typedef details::GetConstRef<T>::type RTT::internal::DataSource< T >::const_reference_t

inherited

Definition at line 107 of file DataSource.hpp.

template<typename T>

typedef T RTT::internal::DataSource< T >::result_t

inherited

Definition at line 106 of file DataSource.hpp.

template<typename T >

typedef boost::intrusive_ptr<AliasDataSource<T> > RTT::internal::AliasDataSource< T >::shared_ptr

Definition at line 268 of file DataSources.hpp.

template<typename T>

typedef T RTT::internal::DataSource< T >::value_t

inherited

The bare type of T is extracted into value_t.

Definition at line 105 of file DataSource.hpp.

Constructor & Destructor Documentation

template<typename T >

RTT::internal::AliasDataSource< T >::AliasDataSource ( DataSource< T > * ds )

inline

Definition at line 270 of file DataSources.hpp.

template<typename T >

RTT::internal::AliasDataSource< T >::~AliasDataSource ( )

inline

Definition at line 274 of file DataSources.hpp.

Member Function Documentation

template<typename T>

RTT::internal::DataSource< T >::BOOST_STATIC_ASSERT ( !details::HasConst< T >::value )

inherited

If you get a compile error here, it means T has const or reference qualifiers, which is not allowed for DataSource<T>

template<typename T >

virtual AliasDataSource<T>* RTT::internal::AliasDataSource< T >::clone ( ) const

inlinevirtual

Return a shallow clone of this DataSource.

This method returns a duplicate of this instance which re-uses the DataSources this internal::DataSource holds reference to. The clone() function is thus a non-deep copy.

Implements RTT::internal::DataSource< T >.

Definition at line 297 of file DataSources.hpp.

References RTT::internal::DataSource< T >::get().

template<typename T >

virtual AliasDataSource<T>* RTT::internal::AliasDataSource< T >::copy ( std::map< const base::DataSourceBase *, base::DataSourceBase * > & alreadyCloned ) const

inlinevirtual

Create a deep copy of this internal::DataSource, unless it is already cloned.

Places the association (parent, clone) in alreadyCloned. If the internal::DataSource is non-copyable (for example it represents the Property of a Task ), this may be returned.

Implements RTT::internal::DataSource< T >.

Definition at line 300 of file DataSources.hpp.

References RTT::internal::DataSource< T >::copy().

void RTT::DataSourceBase::deref ( ) const

inherited

Decrease the reference count by one and delete this on zero.

Definition at line 81 of file DataSource.cpp.

References RTT::os::AtomicInt::dec_and_test(), and RTT::base::DataSourceBase::refcount.

Referenced by RTT::base::intrusive_ptr_release().

template<typename T >

bool RTT::internal::AliasDataSource< T >::evaluate ( ) const

inlinevirtual

Force an evaluation of the DataSourceBase.

Returns: true on successful evaluation.

Reimplemented from RTT::internal::DataSource< T >.

Definition at line 276 of file DataSources.hpp.

References RTT::internal::DataSource< T >::evaluate().

template<typename T >

DataSource<T>::result_t RTT::internal::AliasDataSource< T >::get ( ) const

inlinevirtual

Return the data as type T.

Implements RTT::internal::DataSource< T >.

Definition at line 280 of file DataSources.hpp.

References RTT::internal::DataSource< T >::get().

DataSourceBase::shared_ptr RTT::DataSourceBase::getMember ( const std::string & member_name )

virtualinherited

Get a (const) reference data source to a member of the structure of this data source.

You must call getMember() in turn on the returned member to access sub-members.

Parameters

member_name The name of the member to get access to.

Returns: null if the member does not exist, this if member_name.empty(), and a reference data source to the member otherwise.

Definition at line 124 of file DataSource.cpp.

References RTT::types::TypeInfo::getMember(), and RTT::base::DataSourceBase::getTypeInfo().

DataSourceBase::shared_ptr RTT::DataSourceBase::getMember	(	DataSourceBase::shared_ptr	member_id,
		DataSourceBase::shared_ptr	offset
	)

virtualinherited

Same as above, but with run-time lookup of the member to use.

Also takes an optional offset argument which can be used to offset the member in memory. This is necessary when using sequences of sequences. DataSources which are a sequence/offset member themselves must override this function to let the returned member take the offset into account.

Definition at line 130 of file DataSource.cpp.

References RTT::types::TypeInfo::getMember(), and RTT::base::DataSourceBase::getTypeInfo().

vector< string > RTT::DataSourceBase::getMemberNames ( ) const

virtualinherited

Returns the names of all members of the structure contained in this data source, or an empty list if none.

If this data source is a sequence, it will not return the allowed index numbers.

Definition at line 134 of file DataSource.cpp.

References RTT::types::TypeInfo::getMemberNames(), and RTT::base::DataSourceBase::getTypeInfo().

DataSourceBase::shared_ptr RTT::DataSourceBase::getParent ( )

virtualinherited

Returns the top level data source that contains the full data structure this data source refers to.

Defaults to returning this.

Definition at line 138 of file DataSource.cpp.

template<>

void const * RTT::internal::DataSource< void >::getRawConstPointer ( )

inlinevirtualinherited

Returns a const pointer to the sample contained in this data source, if there is any.

Returns 0 otherwise

Reimplemented from RTT::base::DataSourceBase.

Definition at line 59 of file DataSource.inl.

template<typename T>

void const* RTT::internal::DataSource< T >::getRawConstPointer ( )

inlinevirtualinherited

Generic implementation of getRawConstPointer() based on rvalue()

Reimplemented from RTT::base::DataSourceBase.

Definition at line 141 of file DataSource.hpp.

void * RTT::DataSourceBase::getRawPointer ( )

virtualinherited

Returns a pointer to the sample contained in this data source, if there is any, and if it is an lvalue.

Returns 0 otherwise

Reimplemented in RTT::internal::AssignableDataSource< T >, RTT::internal::AssignableDataSource< DataSourceType >, RTT::internal::AssignableDataSource< types::carray< T > >, RTT::internal::AssignableDataSource< remove_cr< boost::function_traits< Signature >::result_type >::type >, RTT::internal::AssignableDataSource< ds_type >, RTT::internal::AssignableDataSource< RTT::scripting::ProgramInterface * >, RTT::internal::AssignableDataSource< value_t >, and RTT::internal::AssignableDataSource< bool >.

Definition at line 115 of file DataSource.cpp.

template<typename T >

std::string RTT::internal::DataSource< T >::getType ( ) const

virtualinherited

Return useful type info in a human readable format.

Implements RTT::base::DataSourceBase.

Reimplemented in RTT::corba::DataSourceProxy< T >.

Definition at line 20 of file DataSource.inl.

References RTT::internal::DataSource< T >::GetType().

template<typename T >

std::string RTT::internal::DataSource< T >::GetType ( )

staticinherited

Return usefull type info in a human readable format.

Definition at line 32 of file DataSource.inl.

References RTT::internal::DataSourceTypeInfo< T >::getQualifier(), and RTT::internal::DataSourceTypeInfo< T >::getTypeName().

Referenced by RTT::extras::composeProperty(), RTT::corba::DataSourceProxy< T >::getType(), RTT::internal::DataSource< T >::getType(), and RTT::Property< bool >::getType().

template<typename T >

const types::TypeInfo * RTT::internal::DataSource< T >::getTypeInfo ( ) const

virtualinherited

Return the Orocos type info object.

Implements RTT::base::DataSourceBase.

Definition at line 46 of file DataSource.inl.

template<typename T >

const types::TypeInfo * RTT::internal::DataSource< T >::GetTypeInfo ( )

staticinherited

Return the Orocos type info.

Definition at line 49 of file DataSource.inl.

References RTT::internal::DataSourceTypeInfo< T >::getTypeInfo().

Referenced by RTT::internal::create_sequence_impl< List, 1 >::GetTypeInfo(), and RTT::Property< bool >::getTypeInfo().

template<typename T >

std::string RTT::internal::DataSource< T >::GetTypeName ( )

staticinherited

Return the Orocos type name, without const, pointer or reference qualifiers.

Definition at line 39 of file DataSource.inl.

References RTT::internal::DataSourceTypeInfo< T >::getTypeName().

Referenced by RTT::internal::DataSource< T >::getTypeName().

template<typename T >

std::string RTT::internal::DataSource< T >::getTypeName ( ) const

virtualinherited

Return the Orocos type name, without const, pointer or reference qualifiers.

Implements RTT::base::DataSourceBase.

Definition at line 26 of file DataSource.inl.

References RTT::internal::DataSource< T >::GetTypeName().

Referenced by RTT::types::SequenceTypeInfoBase< std::vector< double > >::getMember(), and RTT::corba::RemoteChannelElement< T >::read().

bool RTT::DataSourceBase::isAssignable ( ) const

virtualinherited

Returns true if this object can be cast to an AssignableDataSource.

When this method returns true, all update functions below will return as well when valid input is given.

Reimplemented in RTT::internal::AssignableDataSource< T >, RTT::internal::AssignableDataSource< DataSourceType >, RTT::internal::AssignableDataSource< types::carray< T > >, RTT::internal::AssignableDataSource< remove_cr< boost::function_traits< Signature >::result_type >::type >, RTT::internal::AssignableDataSource< ds_type >, RTT::internal::AssignableDataSource< RTT::scripting::ProgramInterface * >, RTT::internal::AssignableDataSource< value_t >, and RTT::internal::AssignableDataSource< bool >.

Definition at line 104 of file DataSource.cpp.

template<class T >

DataSource< T > * RTT::internal::DataSource< T >::narrow ( base::DataSourceBase * db )

staticinherited

This method narrows a base::DataSourceBase to a typeded DataSource, possibly returning a new object.

Definition at line 66 of file DataSource.inl.

Referenced by RTT::types::EnumTypeInfo< T >::composeType(), RTT::corba::CorbaTemplateProtocol< T >::createAny(), RTT::types::decomposePropertyBag(), RTT::types::EnumTypeInfo< T >::decomposeType(), RTT::types::BoostArrayTypeInfo< T, has_ostream >::getMember(), RTT::types::CArrayTypeInfo< T, has_ostream >::getMember(), RTT::types::SequenceTypeInfoBase< std::vector< double > >::getMember(), RTT::corba::CorbaOperationCallerFactory::produceCollect(), and RTT::corba::CorbaTemplateProtocol< T >::updateAny().

void RTT::DataSourceBase::ref ( ) const

inherited

Increase the reference count by one.

Definition at line 80 of file DataSource.cpp.

References RTT::os::AtomicInt::inc(), and RTT::base::DataSourceBase::refcount.

Referenced by RTT::base::PropertyBase::compose(), RTT::types::BoostArrayTypeInfo< T, has_ostream >::composeType(), RTT::types::CArrayTypeInfo< T, has_ostream >::composeType(), RTT::types::StructTypeInfo< T, has_ostream >::composeTypeImpl(), RTT::corba::DataSourceProxy< T >::get(), RTT::corba::ValueDataSourceProxy< T >::get(), RTT::base::intrusive_ptr_add_ref(), RTT::corba::RemoteChannelElement< T >::read(), RTT::corba::ValueDataSourceProxy< T >::set(), RTT::internal::ReferenceDataSource< ds_type >::setReference(), RTT::base::DataSourceBase::stack_const_ptr(), RTT::base::DataSourceBase::stack_shared_ptr(), and RTT::corba::RemoteChannelElement< T >::write().

template<typename T >

virtual void RTT::internal::AliasDataSource< T >::reset ( )

inlinevirtual

Reset the data to initial values.

Reimplemented from RTT::base::DataSourceBase.

Definition at line 295 of file DataSources.hpp.

References RTT::base::DataSourceBase::reset().

template<typename T >

DataSource<T>::const_reference_t RTT::internal::AliasDataSource< T >::rvalue ( ) const

inlinevirtual

Get a const reference to the value of this DataSource.

You must call evaluate() prior to calling this function in order to get the most recent value of this attribute.

Note: Getting a reference to an internal data structure is not thread-safe.

Implements RTT::internal::DataSource< T >.

Definition at line 290 of file DataSources.hpp.

References RTT::internal::DataSource< T >::rvalue().

DataSourceBase::const_ptr RTT::DataSourceBase::stack_const_ptr ( const DataSourceBase * dsb )

staticinherited

Returns a const shared_ptr to a DataSourceBase living on the stack.

Make sure that the const_ptr does not outlive the stacked element.

Definition at line 74 of file DataSource.cpp.

References RTT::base::DataSourceBase::ref().

DataSourceBase::shared_ptr RTT::DataSourceBase::stack_shared_ptr ( DataSourceBase * dsb )

staticinherited

Returns a shared ptr to a DataSourceBase living on the stack.

Make sure that the shared_ptr does not outlive the stacked element.

Definition at line 69 of file DataSource.cpp.

References RTT::base::DataSourceBase::ref().

std::string RTT::DataSourceBase::toString ( )

inherited

Get the contents of this object as a string.

See also: types::TypeInfo

Definition at line 98 of file DataSource.cpp.

bool RTT::DataSourceBase::update ( DataSourceBase * other )

virtualinherited

Update the value of this internal::DataSource with the value of an other DataSource.

Update does a full update of the value, adding extra information if necessary.

Precondition: this->isAssignable() == true

Returns: false if the DataSources are of different type OR if the contents of this internal::DataSource can not be updated.

Reimplemented in RTT::internal::AssignableDataSource< T >, RTT::internal::AssignableDataSource< DataSourceType >, RTT::internal::AssignableDataSource< types::carray< T > >, RTT::internal::AssignableDataSource< remove_cr< boost::function_traits< Signature >::result_type >::type >, RTT::internal::AssignableDataSource< ds_type >, RTT::internal::AssignableDataSource< RTT::scripting::ProgramInterface * >, RTT::internal::AssignableDataSource< value_t >, and RTT::internal::AssignableDataSource< bool >.

Definition at line 108 of file DataSource.cpp.

ActionInterface * RTT::DataSourceBase::updateAction ( DataSourceBase * other )

virtualinherited

Generate a ActionInterface object which will update this internal::DataSource with the value of another internal::DataSource when execute()'ed.

Precondition: this->isAssignable() == true

Returns: zero if the internal::DataSource types do not match OR if the contents of this internal::DataSource can not be updated.

Reimplemented in RTT::internal::AssignableDataSource< T >, RTT::internal::AssignableDataSource< DataSourceType >, RTT::internal::AssignableDataSource< types::carray< T > >, RTT::internal::AssignableDataSource< remove_cr< boost::function_traits< Signature >::result_type >::type >, RTT::internal::AssignableDataSource< ds_type >, RTT::internal::AssignableDataSource< RTT::scripting::ProgramInterface * >, RTT::internal::AssignableDataSource< value_t >, and RTT::internal::AssignableDataSource< bool >.

Definition at line 120 of file DataSource.cpp.

void RTT::DataSourceBase::updated ( )

virtualinherited

In case the internal::DataSource returns a 'reference' type, call this method to notify it that the data was updated in the course of an invocation of get().

Reimplemented in RTT::corba::ValueDataSourceProxy< T >, RTT::internal::PartDataSource< types::carray< T > >, RTT::internal::ArrayPartDataSource< T >, and RTT::internal::PartDataSource< T >.

Definition at line 112 of file DataSource.cpp.

Referenced by RTT::types::TemplateCompositionFactory< bool >::composeType(), RTT::types::SequenceTypeInfoBase< std::vector< double > >::composeType(), RTT::types::BoolTypeInfo::read(), RTT::types::PrimitiveTypeInfo< std::vector< T >, use_ostream >::read(), RTT::types::SequenceTypeInfoBase< std::vector< double > >::resize(), and RTT::corba::CorbaTemplateProtocol< T >::updateFromAny().

template<typename T >

DataSource<T>::result_t RTT::internal::AliasDataSource< T >::value ( ) const

inlinevirtual

Return the result of the last evaluate() function.

You must call evaluate() prior to calling this function in order to get the most recent value of this attribute.

Implements RTT::internal::DataSource< T >.

Definition at line 285 of file DataSources.hpp.

References RTT::internal::DataSource< T >::value().

std::ostream & RTT::DataSourceBase::write ( std::ostream & os )

inherited

Stream the contents of this object.

See also: types::TypeInfo

Definition at line 91 of file DataSource.cpp.

Member Data Documentation

os::AtomicInt RTT::base::DataSourceBase::refcount

mutableprotectedinherited

We keep the refcount ourselves.

We aren't using boost::shared_ptr, because boost::intrusive_ptr is better, exactly because it can be used with refcounts that are stored in the class itself. Advantages are that the shared_ptr's for derived classes use the same refcount, which is of course very much desired, and that refcounting happens in an efficient way, which is also nice :)

Definition at line 88 of file DataSourceBase.hpp.

Referenced by RTT::base::DataSourceBase::deref(), and RTT::base::DataSourceBase::ref().

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

rtt/internal/DataSources.hpp

Public Types

Public Member Functions

Static Public Member Functions

Protected Attributes

Detailed Description

template<typename T> class RTT::internal::AliasDataSource< T >

Member Typedef Documentation

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation

template<typename T>
class RTT::internal::AliasDataSource< T >