InPort template class. More...
#include <InPort.h>
Public Member Functions | |
DATAPORTSTATUS_ENUM | InPort (const char *name, DataType &value, int bufsize=64, bool read_block=false, bool write_block=false, int read_timeout=0, int write_timeout=0) |
A constructor. | |
virtual bool | isEmpty () |
Check whether the data is newest. | |
virtual bool | isNew () |
Check whether the data is newest. | |
virtual const char * | name () |
Get port name. | |
void | operator>> (DataType &rhs) |
Read the newly value data in InPort to type-T variable. | |
bool | read () |
Readout the value from DataPort. | |
void | setOnRead (OnRead< DataType > *on_read) |
Set callback when data is read from the InPort buffer. | |
void | setOnReadConvert (OnReadConvert< DataType > *on_rconvert) |
Set callback when data is readout to the InPort buffer. | |
virtual void | update () |
Read the newly value to type-T variable which is bound to InPort's buffer. | |
virtual | ~InPort (void) |
Destructor. | |
Private Attributes | |
std::string | m_name |
OnRead< DataType > * | m_OnRead |
Pointer to OnRead callback functor. | |
OnReadConvert< DataType > * | m_OnReadConvert |
Pointer to OnReadConvert callback functor. | |
std::string | m_typename |
DataType & | m_value |
The reference to type-T value bound this OutPort. |
InPort template class.
This is a template class that implements InPort. <T> is the type defined in BasicDataType.idl and must be the structure which has both Time type tm and type-T data as a member. InPort has a ring buffer internally, and stores the received data externally in this buffer one by one. The size of ring buffer can be specified according to the argument of constructor, though the default size is 64. Unread data and data which is already read are managed with the flag, and the data can be handled by the isNew(), write(), read(), isFull() and isEmpty() method etc.
DATAPORTSTATUS_ENUM RTC::InPort< DataType >::InPort | ( | const char * | name, |
DataType & | value, | ||
int | bufsize = 64 , |
||
bool | read_block = false , |
||
bool | write_block = false , |
||
int | read_timeout = 0 , |
||
int | write_timeout = 0 |
||
) | [inline] |
A constructor.
constructor. This is bound to type-T variable given as a parameter.
name | A name of the InPort. This name is referred by InPortBase::name(). |
value | type-T variable that is bound to this InPort. |
bufsize | Buffer length of internal ring buffer of InPort (The default value:64) |
read_block | Flag of reading block. When there are not unread data at reading data, set whether to block data until receiving the next data. (The default value:false) |
write_block | Flag of writing block. If the buffer was full at writing data, set whether to block data until the buffer has space. (The default value:false) |
read_timeout | Data reading timeout time (millisecond) when not specifying read blocking. (The default value:0) |
write_timeout | Data writing timeout time (millisecond) when not specifying writing block. (The default value:0) |
virtual RTC::InPort< DataType >::~InPort | ( | void | ) | [inline, virtual] |
virtual bool RTC::InPort< DataType >::isEmpty | ( | void | ) | [inline, virtual] |
virtual bool RTC::InPort< DataType >::isNew | ( | ) | [inline, virtual] |
virtual const char* RTC::InPort< DataType >::name | ( | ) | [inline, virtual] |
void RTC::InPort< DataType >::operator>> | ( | DataType & | rhs | ) | [inline] |
bool RTC::InPort< DataType >::read | ( | ) | [inline, virtual] |
Readout the value from DataPort.
Readout the value from DataPort
Implements RTC::InPortBase.
void RTC::InPort< DataType >::setOnRead | ( | OnRead< DataType > * | on_read | ) | [inline] |
void RTC::InPort< DataType >::setOnReadConvert | ( | OnReadConvert< DataType > * | on_rconvert | ) | [inline] |
Set callback when data is readout to the InPort buffer.
Set the callback object that is invoked when data is readout to the InPort's buffer. The return value of callback object is the return result of the read() method.
on_rconvert | OnReadConvert<DataType> type object |
virtual void RTC::InPort< DataType >::update | ( | void | ) | [inline, virtual] |
Read the newly value to type-T variable which is bound to InPort's buffer.
Read the newly value to type-T data which is bound to InPort's buffer. The type-T variable must be bound to InPort in constructor. Since this method assumes to be used for polymorphic, its argument and the return value do not depend on type.
std::string RTC::InPort< DataType >::m_name [private] |
OnRead<DataType>* RTC::InPort< DataType >::m_OnRead [private] |
OnReadConvert<DataType>* RTC::InPort< DataType >::m_OnReadConvert [private] |
Pointer to OnReadConvert callback functor.
std::string RTC::InPort< DataType >::m_typename [private] |
DataType& RTC::InPort< DataType >::m_value [private] |