Orocos Real-Time Toolkit
2.9.0
|
A DataSource which is used to manipulate a reference to an external value, by means of a pointer, which can be set after the data source was created. More...
#include <rtt/internal/DataSources.hpp>
Public Types | |
typedef boost::intrusive_ptr< LateReferenceDataSource< T > > | shared_ptr |
typedef DataSource< T >::value_t | value_t |
typedef DataSource< T >::const_reference_t | const_reference_t |
typedef boost::call_traits< value_t >::param_type | param_t |
typedef boost::call_traits< value_t >::reference | reference_t |
typedef boost::intrusive_ptr< const AssignableDataSource< T > > | const_ptr |
typedef T | result_t |
Public Member Functions | |
LateReferenceDataSource (typename AssignableDataSource< T >::value_t *ptr=0) | |
void | setPointer (typename AssignableDataSource< T >::value_t *ptr) |
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... | |
void const * | getRawDataConst () |
void * | getRawData () |
void | set (typename AssignableDataSource< T >::param_t t) |
AssignableDataSource< T >::reference_t | set () |
Get a reference to the value of this DataSource. More... | |
AssignableDataSource< T >::const_reference_t | rvalue () const |
Get a const reference to the value of this DataSource. More... | |
virtual LateReferenceDataSource< T > * | clone () const |
Return a shallow clone of this DataSource. More... | |
virtual LateReferenceDataSource< T > * | copy (std::map< const base::DataSourceBase *, base::DataSourceBase * > &) const |
Create a deep copy of this internal::DataSource, unless it is already cloned. More... | |
virtual void | set (param_t t)=0 |
Set this DataSource with a value. More... | |
void * | getRawPointer () |
Generic implementation of getRawPointer() based on set() More... | |
virtual bool | isAssignable () const |
Returns true if this object can be cast to an AssignableDataSource. More... | |
virtual bool | update (base::DataSourceBase *other) |
Update the value of this internal::DataSource with the value of an other DataSource. More... | |
virtual base::ActionInterface * | updateAction (base::DataSourceBase *other) |
Generate a ActionInterface object which will update this internal::DataSource with the value of another internal::DataSource when execute()'ed. 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 bool | evaluate () const |
Force an evaluation of the DataSourceBase. 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 void | reset () |
Reset the data to initial values. 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 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... | |
Static Public Member Functions | |
static AssignableDataSource< T > * | narrow (base::DataSourceBase *db) |
This method narrows a base::DataSourceBase to a typeded AssignableDataSource, possibly returning a new object. More... | |
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 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... | |
A DataSource which is used to manipulate a reference to an external value, by means of a pointer, which can be set after the data source was created.
It's the responsibility of the creator of this object that the data source is not used before the pointer is set using setPointer.
T | The result data type of get(). |
Definition at line 385 of file DataSources.hpp.
|
inherited |
Definition at line 199 of file DataSource.hpp.
|
inherited |
Definition at line 191 of file DataSource.hpp.
|
inherited |
Definition at line 192 of file DataSource.hpp.
|
inherited |
Definition at line 193 of file DataSource.hpp.
|
inherited |
Definition at line 106 of file DataSource.hpp.
typedef boost::intrusive_ptr<LateReferenceDataSource<T> > RTT::internal::LateReferenceDataSource< T >::shared_ptr |
Definition at line 392 of file DataSources.hpp.
|
inherited |
Definition at line 190 of file DataSource.hpp.
|
inline |
Definition at line 394 of file DataSources.hpp.
|
inherited |
If you get a compile error here, it means T has const or reference qualifiers, which is not allowed for DataSource<T>
|
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::AssignableDataSource< T >.
Definition at line 434 of file DataSources.hpp.
|
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::AssignableDataSource< T >.
Definition at line 438 of file DataSources.hpp.
|
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().
|
virtualinherited |
Force an evaluation of the DataSourceBase.
Implements RTT::base::DataSourceBase.
Reimplemented in RTT::internal::ActionAliasAssignableDataSource< T >, RTT::internal::ActionAliasDataSource< T >, RTT::internal::FusedMCallDataSource< Signature >, RTT::internal::AliasDataSource< T >, RTT::internal::FusedFunctorDataSource< Signature, typename boost::enable_if< is_pure_reference< typename boost::function_traits< Signature >::result_type > >::type >, RTT::internal::FusedFunctorDataSource< Signature, Enable >, RTT::scripting::CmdFunction, RTT::internal::InputPortSource< T >, RTT::CmdFunctionWrapper, and RTT::internal::DataObjectDataSource< T >.
Definition at line 52 of file DataSource.inl.
Referenced by RTT::corba::CorbaTemplateProtocol< T >::createAny(), RTT::CmdFunctionWrapper::evaluate(), RTT::internal::AliasDataSource< T >::evaluate(), RTT::internal::ActionAliasDataSource< T >::evaluate(), RTT::internal::ActionAliasAssignableDataSource< T >::evaluate(), RTT::scripting::CommandDataSourceBool::execute(), RTT::scripting::EvalCommand::execute(), RTT::Attribute< T >::get(), RTT::Property< bool >::Property(), RTT::internal::ReferenceDataSource< ds_type >::setReference(), RTT::internal::AssignableDataSource< T >::update(), RTT::corba::CorbaTemplateProtocol< T >::updateAny(), and RTT::SendHandleC::E::OperationKeeper::~OperationKeeper().
|
inlinevirtual |
Return the data as type T.
Implements RTT::internal::DataSource< T >.
Definition at line 401 of file DataSources.hpp.
|
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.
member_name | The name of the member to get access to. |
Definition at line 124 of file DataSource.cpp.
References RTT::types::TypeInfo::getMember(), and RTT::base::DataSourceBase::getTypeInfo().
|
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().
|
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().
|
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.
|
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.
|
inlinevirtualinherited |
Generic implementation of getRawConstPointer() based on rvalue()
Reimplemented from RTT::base::DataSourceBase.
Definition at line 141 of file DataSource.hpp.
|
inline |
Definition at line 415 of file DataSources.hpp.
|
inline |
Definition at line 411 of file DataSources.hpp.
|
inlinevirtualinherited |
Generic implementation of getRawPointer() based on set()
Reimplemented from RTT::base::DataSourceBase.
Definition at line 214 of file DataSource.hpp.
|
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().
|
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().
|
virtualinherited |
Return the Orocos type info object.
Implements RTT::base::DataSourceBase.
Definition at line 46 of file DataSource.inl.
|
staticinherited |
Definition at line 49 of file DataSource.inl.
References RTT::internal::DataSourceTypeInfo< T >::getTypeInfo().
Referenced by RTT::Property< bool >::getTypeInfo(), and RTT::internal::create_sequence_impl< List, 1 >::GetTypeInfo().
|
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().
|
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().
|
inlinevirtualinherited |
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 from RTT::base::DataSourceBase.
Definition at line 216 of file DataSource.hpp.
|
staticinherited |
This method narrows a base::DataSourceBase to a typeded AssignableDataSource, possibly returning a new object.
Definition at line 72 of file DataSource.inl.
Referenced by RTT::types::TemplateValueFactory< bool >::buildAttribute(), RTT::types::EnumTypeInfo< T >::composeType(), RTT::Property< bool >::create(), CorbaOperationCallerCall::execute(), RTT::types::SequenceTypeInfoBase< std::vector< double > >::resize(), RTT::Property< bool >::setDataSource(), RTT::corba::CorbaTemplateProtocol< T >::updateFromAny(), RTT::mqueue::MQTemplateProtocol< T >::updateFromBlob(), and RTT::mqueue::MQSerializationProtocol< T >::updateFromBlob().
|
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().
|
virtualinherited |
Reset the data to initial values.
Reimplemented in RTT::internal::NArityDataSource< function >, RTT::internal::UnaryDataSource< function >, RTT::internal::BinaryDataSource< function >, RTT::internal::ActionAliasAssignableDataSource< T >, RTT::internal::ActionAliasDataSource< T >, RTT::internal::FusedMSendDataSource< Signature >, RTT::internal::AliasDataSource< T >, RTT::scripting::CmdFunction, RTT::CmdFunctionWrapper, RTT::internal::InputPortSource< T >, RTT::scripting::DataSourceTime, RTT::internal::DataSourceCommand, RTT::scripting::DataSourceCondition, and RTT::internal::DataObjectDataSource< T >.
Definition at line 87 of file DataSource.cpp.
Referenced by RTT::StatementProcessor::D::doPrint(), RTT::scripting::ConditionBoolDataSource::reset(), RTT::scripting::CommandDataSourceBool::reset(), RTT::scripting::EvalCommand::reset(), RTT::internal::AliasDataSource< T >::reset(), RTT::internal::ActionAliasDataSource< T >::reset(), RTT::internal::ActionAliasAssignableDataSource< T >::reset(), RTT::internal::BinaryDataSource< function >::reset(), RTT::internal::UnaryDataSource< function >::reset(), and RTT::internal::NArityDataSource< function >::reset().
|
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.
Implements RTT::internal::DataSource< T >.
Definition at line 429 of file DataSources.hpp.
|
pure virtualinherited |
Set this DataSource with a value.
Referenced by RTT::types::TemplateCompositionFactory< bool >::composeType(), RTT::types::StdVectorTypeInfo::composeType(), RTT::types::StdVectorTemplateTypeInfo< T, has_ostream >::composeType(), RTT::types::EnumTypeInfo< T >::composeType(), RTT::types::BoostArrayTypeInfo< T, has_ostream >::composeType(), RTT::types::SequenceTypeInfoBase< std::vector< double > >::composeType(), RTT::types::CArrayTypeInfo< T, has_ostream >::composeType(), RTT::Property< bool >::copy(), RTT::scripting::ConditionCache::evaluate(), RTT::scripting::TryCommand::execute(), RTT::scripting::EvalCommand::execute(), CorbaOperationCallerCall::execute(), RTT::corba::ValueDataSourceProxy< T >::get(), RTT::types::BoostArrayTypeInfo< T, has_ostream >::getMember(), RTT::types::StructTypeInfo< T, has_ostream >::getMember(), RTT::types::CArrayTypeInfo< T, has_ostream >::getMember(), RTT::Property< bool >::operator=(), RTT::types::BoolTypeInfo::read(), RTT::types::PrimitiveTypeInfo< std::vector< T >, use_ostream >::read(), RTT::InputPort< T >::read(), RTT::scripting::TryCommand::readArguments(), RTT::InputPort< T >::readNewest(), RTT::Property< bool >::refresh(), RTT::scripting::ConditionCache::reset(), RTT::scripting::TryCommand::reset(), RTT::scripting::EvalCommand::reset(), RTT::types::SequenceTypeInfoBase< std::vector< double > >::resize(), RTT::corba::ValueDataSourceProxy< T >::set(), RTT::Attribute< T >::set(), RTT::Property< bool >::set(), RTT::internal::ActionAliasAssignableDataSource< T >::set(), RTT::internal::ReferenceDataSource< ds_type >::setReference(), RTT::Property< bool >::update(), RTT::corba::CorbaTemplateProtocol< T >::updateFromAny(), RTT::mqueue::MQTemplateProtocol< T >::updateFromBlob(), RTT::mqueue::MQSerializationProtocol< T >::updateFromBlob(), and RTT::SendHandleC::E::OperationKeeper::~OperationKeeper().
|
inline |
Definition at line 420 of file DataSources.hpp.
|
inlinevirtual |
Get a reference to the value of this DataSource.
Getting a reference to an internal data structure is not thread-safe.
Implements RTT::internal::AssignableDataSource< T >.
Definition at line 424 of file DataSources.hpp.
|
inline |
Definition at line 397 of file DataSources.hpp.
Referenced by RTT::internal::DataSourceArgStorage< A & >::newarg().
|
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().
|
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().
|
inherited |
Get the contents of this object as a string.
Definition at line 98 of file DataSource.cpp.
|
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.
Reimplemented from RTT::base::DataSourceBase.
Definition at line 78 of file DataSource.inl.
References RTT::types::TypeInfo::convert(), RTT::internal::DataSource< T >::evaluate(), RTT::internal::DataSourceTypeInfo< T >::getTypeInfo(), and RTT::internal::DataSource< T >::value().
|
virtualinherited |
Generate a ActionInterface object which will update this internal::DataSource with the value of another internal::DataSource when execute()'ed.
Reimplemented from RTT::base::DataSourceBase.
Definition at line 94 of file DataSource.inl.
References RTT::types::TypeInfo::convert(), and RTT::internal::DataSourceTypeInfo< T >::getTypeInfo().
|
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().
|
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 406 of file DataSources.hpp.
|
inherited |
Stream the contents of this object.
Definition at line 91 of file DataSource.cpp.
|
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().