Public Types | Public Member Functions | Static Public Member Functions | Protected Member Functions | Protected Attributes
RTT::base::DataSourceBase Class Reference

The base class for all internal data representations. More...

#include <DataSourceBase.hpp>

Inheritance diagram for RTT::base::DataSourceBase:
Inheritance graph
[legend]

List of all members.

Public Types

typedef boost::intrusive_ptr
< const DataSourceBase
const_ptr
typedef boost::intrusive_ptr
< DataSourceBase
shared_ptr

Public Member Functions

virtual DataSourceBaseclone () const =0
virtual DataSourceBasecopy (std::map< const DataSourceBase *, DataSourceBase * > &alreadyCloned) const =0
 DataSourceBase ()
void deref () const
virtual bool evaluate () const =0
virtual shared_ptr getMember (const std::string &member_name)
virtual shared_ptr getMember (DataSourceBase::shared_ptr member_id, DataSourceBase::shared_ptr offset)
virtual std::vector< std::string > getMemberNames () const
virtual shared_ptr getParent ()
virtual void const * getRawConstPointer ()
virtual void * getRawPointer ()
virtual std::string getType () const =0
virtual const types::TypeInfogetTypeInfo () const =0
virtual std::string getTypeName () const =0
virtual bool isAssignable () const
void ref () const
virtual void reset ()
std::string toString ()
virtual bool update (DataSourceBase *other)
virtual ActionInterfaceupdateAction (DataSourceBase *other)
virtual void updated ()
std::ostream & write (std::ostream &os)

Static Public Member Functions

static const_ptr stack_const_ptr (const DataSourceBase *dsb)
static shared_ptr stack_shared_ptr (DataSourceBase *dsb)

Protected Member Functions

virtual ~DataSourceBase ()

Protected Attributes

os::AtomicInt refcount

Detailed Description

The base class for all internal data representations.

The internal::DataSource is an object containing Data of any type. It's interface is designed for dynamic build-up and destruction of these objects and allowing Commands, Properties etc to use them as 'storage' devices which have the dual copy() /clone() semantics (which is heavily used by the Orocos type and scripting Infrastructure).

internal::DataSource's are reference counted and must be allocated on the heap. Use DataSourceBase::shared_ptr or internal::DataSource<T>::shared_ptr to deal with cleanup of allocated DataSources. You are not allowed to delete a DataSource. If you must have the pointer of a internal::DataSource, use the .get() method of the shared_ptr class.

Once a newly created internal::DataSource is assigned to a shared_ptr, it will be deleted when that pointer goes out of scope and is not shared by other shared_ptr objects.

See also:
internal::DataSource

Definition at line 76 of file DataSourceBase.hpp.


Member Typedef Documentation

typedef boost::intrusive_ptr<const DataSourceBase> RTT::base::DataSourceBase::const_ptr

Use this type to store a const pointer to a DataSourceBase.

Reimplemented in RTT::internal::AssignableDataSource< T >, RTT::internal::AssignableDataSource< ProgramInterfacePtr >, RTT::internal::AssignableDataSource< DataSourceType >, RTT::internal::AssignableDataSource< int >, 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< value_t >, RTT::internal::AssignableDataSource< ProgramInterface * >, RTT::internal::AssignableDataSource< bool >, RTT::internal::AssignableDataSource< StateMachinePtr >, RTT::internal::DataSource< T >, RTT::internal::DataSource< ProgramInterfacePtr >, RTT::internal::DataSource< DataSourceType >, RTT::internal::DataSource< SendStatus >, RTT::internal::DataSource< double >, RTT::internal::DataSource< offset_type >, RTT::internal::DataSource< SendHandle< Signature > >, RTT::internal::DataSource< A >, RTT::internal::DataSource< int >, RTT::internal::DataSource< S >, RTT::internal::DataSource< CORBA::Any_var >, RTT::internal::DataSource< unsigned int >, RTT::internal::DataSource< types::carray< T > >, RTT::internal::DataSource< remove_cr< function::result_type >::type >, RTT::internal::DataSource< os::TimeService::Seconds >, RTT::internal::DataSource< arg_t >, RTT::internal::DataSource< remove_cr< boost::function_traits< Signature >::result_type >::type >, RTT::internal::DataSource< second_arg_t >, RTT::internal::DataSource< ds_type >, RTT::internal::DataSource< value_t >, RTT::internal::DataSource< ProgramInterface * >, RTT::internal::DataSource< bool >, RTT::internal::DataSource< StateMachinePtr >, RTT::internal::DataSource< boost::shared_ptr< ObjT > >, and RTT::internal::DataSource< first_arg_t >.

Definition at line 104 of file DataSourceBase.hpp.

Use this type to store a pointer to a DataSourceBase.

Reimplemented in RTT::internal::NArityDataSource< function >, RTT::internal::UnaryDataSource< function >, RTT::internal::BinaryDataSource< function >, RTT::internal::ActionAliasAssignableDataSource< T >, RTT::internal::ActionAliasDataSource< T >, RTT::internal::LateConstReferenceDataSource< T >, RTT::internal::LateConstReferenceDataSource< A >, RTT::internal::FusedMCollectDataSource< Signature >, RTT::internal::LateReferenceDataSource< T >, RTT::internal::LateReferenceDataSource< ds_type >, RTT::internal::FusedMSendDataSource< Signature >, RTT::internal::ArrayDataSource< T >, RTT::internal::AliasDataSource< T >, RTT::internal::FusedMCallDataSource< Signature >, RTT::internal::ReferenceDataSource< T >, RTT::internal::ReferenceDataSource< ds_type >, RTT::internal::AssignableDataSource< T >, RTT::internal::AssignableDataSource< ProgramInterfacePtr >, RTT::internal::AssignableDataSource< DataSourceType >, RTT::internal::AssignableDataSource< int >, 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< value_t >, RTT::internal::AssignableDataSource< ProgramInterface * >, RTT::internal::AssignableDataSource< bool >, RTT::internal::AssignableDataSource< StateMachinePtr >, RTT::internal::ConstReferenceDataSource< T >, RTT::internal::FusedFunctorDataSource< Signature, typename boost::enable_if< is_pure_reference< typename boost::function_traits< Signature >::result_type > >::type >, RTT::internal::OffsetPartDataSource< T >, RTT::internal::PartDataSource< types::carray< T > >, RTT::internal::ConstantDataSource< T >, RTT::internal::DataSource< T >, RTT::internal::DataSource< ProgramInterfacePtr >, RTT::internal::DataSource< DataSourceType >, RTT::internal::DataSource< SendStatus >, RTT::internal::DataSource< double >, RTT::internal::DataSource< offset_type >, RTT::internal::DataSource< SendHandle< Signature > >, RTT::internal::DataSource< A >, RTT::internal::DataSource< int >, RTT::internal::DataSource< S >, RTT::internal::DataSource< CORBA::Any_var >, RTT::internal::DataSource< unsigned int >, RTT::internal::DataSource< types::carray< T > >, RTT::internal::DataSource< remove_cr< function::result_type >::type >, RTT::internal::DataSource< os::TimeService::Seconds >, RTT::internal::DataSource< arg_t >, RTT::internal::DataSource< remove_cr< boost::function_traits< Signature >::result_type >::type >, RTT::internal::DataSource< second_arg_t >, RTT::internal::DataSource< ds_type >, RTT::internal::DataSource< value_t >, RTT::internal::DataSource< ProgramInterface * >, RTT::internal::DataSource< bool >, RTT::internal::DataSource< StateMachinePtr >, RTT::internal::DataSource< boost::shared_ptr< ObjT > >, RTT::internal::DataSource< first_arg_t >, RTT::internal::FusedFunctorDataSource< Signature, Enable >, RTT::corba::AnyDataSource, RTT::internal::ArrayPartDataSource< T >, RTT::internal::InputPortSource< T >, RTT::internal::ValueDataSource< T >, RTT::internal::PartDataSource< T >, RTT::internal::ValueDataSource< ProgramInterfacePtr >, RTT::internal::ValueDataSource< ds_type >, RTT::internal::ValueDataSource< StateMachinePtr >, RTT::internal::OffsetDataSource, and RTT::internal::DataObjectDataSource< T >.

Definition at line 99 of file DataSourceBase.hpp.


Constructor & Destructor Documentation

RTT::DataSourceBase::~DataSourceBase ( ) [protected, virtual]

the destructor is private. You are not allowed to delete this class RTT_API yourself, use a shared pointer !

Definition at line 83 of file DataSource.cpp.

Definition at line 79 of file DataSource.cpp.


Member Function Documentation

virtual DataSourceBase* RTT::base::DataSourceBase::clone ( ) const [pure virtual]

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.

Implemented in RTT::internal::NArityDataSource< function >, RTT::internal::UnaryDataSource< function >, RTT::internal::BinaryDataSource< function >, RTT::internal::ActionAliasAssignableDataSource< T >, RTT::internal::ActionAliasDataSource< T >, RTT::internal::LateConstReferenceDataSource< T >, RTT::internal::LateConstReferenceDataSource< A >, RTT::internal::FusedMCollectDataSource< Signature >, RTT::internal::LateReferenceDataSource< T >, RTT::internal::LateReferenceDataSource< ds_type >, RTT::internal::ArrayDataSource< T >, RTT::internal::FusedMSendDataSource< Signature >, RTT::internal::FusedMCallDataSource< Signature >, RTT::internal::AliasDataSource< T >, RTT::internal::ReferenceDataSource< T >, RTT::internal::ReferenceDataSource< ds_type >, RTT::internal::AssignableDataSource< T >, RTT::internal::AssignableDataSource< ProgramInterfacePtr >, RTT::internal::AssignableDataSource< DataSourceType >, RTT::internal::AssignableDataSource< int >, 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< value_t >, RTT::internal::AssignableDataSource< ProgramInterface * >, RTT::internal::AssignableDataSource< bool >, RTT::internal::AssignableDataSource< StateMachinePtr >, RTT::internal::OffsetPartDataSource< T >, RTT::corba::ValueDataSourceProxy< T >, RTT::internal::FusedFunctorDataSource< Signature, typename boost::enable_if< is_pure_reference< typename boost::function_traits< Signature >::result_type > >::type >, RTT::internal::ConstReferenceDataSource< T >, RTT::internal::PartDataSource< types::carray< T > >, RTT::internal::ConstantDataSource< T >, RTT::internal::DataSource< T >, RTT::internal::DataSource< ProgramInterfacePtr >, RTT::internal::DataSource< DataSourceType >, RTT::internal::DataSource< SendStatus >, RTT::internal::DataSource< double >, RTT::internal::DataSource< offset_type >, RTT::internal::DataSource< SendHandle< Signature > >, RTT::internal::DataSource< A >, RTT::internal::DataSource< int >, RTT::internal::DataSource< S >, RTT::internal::DataSource< CORBA::Any_var >, RTT::internal::DataSource< unsigned int >, RTT::internal::DataSource< types::carray< T > >, RTT::internal::DataSource< remove_cr< function::result_type >::type >, RTT::internal::DataSource< os::TimeService::Seconds >, RTT::internal::DataSource< arg_t >, RTT::internal::DataSource< remove_cr< boost::function_traits< Signature >::result_type >::type >, RTT::internal::DataSource< second_arg_t >, RTT::internal::DataSource< ds_type >, RTT::internal::DataSource< value_t >, RTT::internal::DataSource< ProgramInterface * >, RTT::internal::DataSource< bool >, RTT::internal::DataSource< StateMachinePtr >, RTT::internal::DataSource< boost::shared_ptr< ObjT > >, RTT::internal::DataSource< first_arg_t >, RTT::internal::ArrayPartDataSource< T >, RTT::internal::FusedFunctorDataSource< Signature, Enable >, RTT::corba::DataSourceProxy< T >, RTT::internal::PartDataSource< T >, RTT::internal::InputPortSource< T >, RTT::internal::ValueDataSource< T >, RTT::internal::ValueDataSource< ProgramInterfacePtr >, RTT::internal::ValueDataSource< ds_type >, RTT::internal::ValueDataSource< StateMachinePtr >, RTT::internal::OffsetDataSource, RTT::corba::AnyDataSource, RTT::scripting::DataSourceTime, RTT::internal::DataSourceCommand, RTT::scripting::DataSourceCondition, and RTT::internal::DataObjectDataSource< T >.

virtual DataSourceBase* RTT::base::DataSourceBase::copy ( std::map< const DataSourceBase *, DataSourceBase * > &  alreadyCloned) const [pure virtual]

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.

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

Definition at line 81 of file DataSource.cpp.

virtual bool RTT::base::DataSourceBase::evaluate ( ) const [pure virtual]

Force an evaluation of the DataSourceBase.

Returns:
true on successful evaluation.

Implemented in RTT::internal::ActionAliasAssignableDataSource< T >, RTT::internal::ActionAliasDataSource< T >, RTT::internal::AliasDataSource< T >, RTT::internal::FusedMCallDataSource< Signature >, RTT::internal::FusedFunctorDataSource< Signature, typename boost::enable_if< is_pure_reference< typename boost::function_traits< Signature >::result_type > >::type >, RTT::internal::DataSource< T >, RTT::internal::DataSource< ProgramInterfacePtr >, RTT::internal::DataSource< DataSourceType >, RTT::internal::DataSource< SendStatus >, RTT::internal::DataSource< double >, RTT::internal::DataSource< offset_type >, RTT::internal::DataSource< SendHandle< Signature > >, RTT::internal::DataSource< A >, RTT::internal::DataSource< int >, RTT::internal::DataSource< S >, RTT::internal::DataSource< CORBA::Any_var >, RTT::internal::DataSource< unsigned int >, RTT::internal::DataSource< types::carray< T > >, RTT::internal::DataSource< remove_cr< function::result_type >::type >, RTT::internal::DataSource< os::TimeService::Seconds >, RTT::internal::DataSource< arg_t >, RTT::internal::DataSource< remove_cr< boost::function_traits< Signature >::result_type >::type >, RTT::internal::DataSource< second_arg_t >, RTT::internal::DataSource< ds_type >, RTT::internal::DataSource< value_t >, RTT::internal::DataSource< ProgramInterface * >, RTT::internal::DataSource< bool >, RTT::internal::DataSource< StateMachinePtr >, RTT::internal::DataSource< boost::shared_ptr< ObjT > >, RTT::internal::DataSource< first_arg_t >, RTT::internal::FusedFunctorDataSource< Signature, Enable >, RTT::internal::InputPortSource< T >, and RTT::internal::DataObjectDataSource< T >.

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

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_nameThe 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.

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.

vector< string > RTT::DataSourceBase::getMemberNames ( ) const [virtual]

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.

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

Reimplemented in RTT::internal::OffsetPartDataSource< T >.

Definition at line 138 of file DataSource.cpp.

void const * RTT::DataSourceBase::getRawConstPointer ( ) [virtual]
void * RTT::DataSourceBase::getRawPointer ( ) [virtual]
virtual std::string RTT::base::DataSourceBase::getType ( ) const [pure virtual]
virtual const types::TypeInfo* RTT::base::DataSourceBase::getTypeInfo ( ) const [pure virtual]
virtual std::string RTT::base::DataSourceBase::getTypeName ( ) const [pure virtual]
bool RTT::DataSourceBase::isAssignable ( ) const [virtual]
void RTT::DataSourceBase::ref ( ) const

Increase the reference count by one.

Definition at line 80 of file DataSource.cpp.

void RTT::DataSourceBase::reset ( void  ) [virtual]

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.

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.

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) [virtual]
void RTT::DataSourceBase::updated ( ) [virtual]

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::OffsetPartDataSource< T >, RTT::internal::PartDataSource< types::carray< T > >, RTT::internal::ArrayPartDataSource< T >, and RTT::internal::PartDataSource< T >.

Definition at line 112 of file DataSource.cpp.

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

Stream the contents of this object.

See also:
types::TypeInfo

Definition at line 91 of file DataSource.cpp.


Member Data Documentation

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.


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


rtt
Author(s): RTT Developers
autogenerated on Thu Jan 2 2014 11:35:43