RTT::ReadDataPort< T > Class Template Reference
[Data Transfer Ports]

A Port to a readable Data Connection. More...

#include <rtt/DataPort.hpp>

Inherits RTT::DataPortBase< T >.

List of all members.

Public Types

typedef T DataType
enum  PortType { ReadPort, WritePort, ReadWritePort }
 

This enum classifies if a port is inbound outbound or both.


enum  ConnectionModel { Buffered, Data }
 

This enum classifies the kind of data connections that are available through ports: buffered or data.


typedef Event< void(PortInterface *) NewDataOnPortEvent )

Public Member Functions

 ReadDataPort (const std::string &name)
 Construct an unconnected Port to a readable data object.
Get () const
 Get the current value of this Port.
void Get (T &result)
 Get the current value of this Port.
virtual PortInterface::PortType getPortType () const
 Get the PortType of this port.
virtual PortInterfaceclone () const
 Create a clone of this port with the same name.
virtual PortInterfaceantiClone () const
 Create the anti-clone (inverse port) of this port with the same name A port for reading will return a new port for writing and vice versa.
virtual TaskObjectcreatePortObject ()
 Create accessor Object for this Port, for addition to a TaskContext Object interface.
ConnectionInterface::shared_ptr createConnection (DataSourceBase::shared_ptr data)
virtual
ConnectionInterface::shared_ptr 
createConnection (ConnectionTypes::ConnectionType con_type=ConnectionTypes::lockfree)
 Create a new connection object to which this port is subscribed.
virtual
ConnectionInterface::shared_ptr 
createConnection (BufferBase::shared_ptr buf)
 Create a new connection object using a buffered connection implementation.
virtual ConnectionModel getConnectionModel () const
virtual const TypeInfogetTypeInfo () const
bool connect (ConnectionInterface::shared_ptr conn)
virtual
ConnectionInterface::shared_ptr 
connection () const
bool connected () const
bool connectTo (ConnectionInterface::shared_ptr other)
virtual bool connectTo (PortInterface *other)
 Connect to another Port and create a new connection if necessary.
void disconnect ()
const DataObjectInterface< T > * data () const
 Get the data object to read from.
DataObjectInterface< T > * data ()
 Get the data object to write to.
const std::string & getName () const
 Get the name of this Port.
bool setName (const std::string &name)
 Change the name of this unconnected Port.
bool ready () const
 Returns true if this Port is ready to be used.
void signal ()
 Call this method to signal that new data is available on this port.
NewDataOnPortEvent * getNewDataOnPortEvent ()
 Returns an Event object which is triggered every time new data is made available on this port.
virtual int serverProtocol () const
 Returns the protocol over which this port can be accessed.

Protected Attributes

DataConnection< T >::shared_ptr mconn
 The connection to read from.
std::string portname
NewDataOnPortEvent * new_data_on_port_event

Friends

class ConnectionInterface

Detailed Description

template<class T>
class RTT::ReadDataPort< T >

A Port to a readable Data Connection.

Use connection() to access the data object. If the port is not connected, connection() returns null.

Parameters:
T The type of the data of the data object.

Definition at line 132 of file DataPort.hpp.


Constructor & Destructor Documentation

template<class T>
RTT::ReadDataPort< T >::ReadDataPort ( const std::string &  name  )  [inline]

Construct an unconnected Port to a readable data object.

Parameters:
name The name of this port.

Definition at line 144 of file DataPort.hpp.


Member Function Documentation

virtual bool RTT::PortInterface::connectTo ( PortInterface other  )  [virtual, inherited]

Connect to another Port and create a new connection if necessary.

  • If this port is already connected, this method returns false.
  • If the other port has a connection, this method is equivalent to 'this->connectTo( other->connection() )'.
  • If the other port is not connected, a new connection is created and both ports are connected.
    Returns:
    true upon success, false otherwise.

Referenced by RTT::ReadBufferPort< T >::antiClone().

virtual ConnectionInterface::shared_ptr RTT::PortInterface::createConnection ( BufferBase::shared_ptr  buf  )  [virtual, inherited]

Create a new connection object using a buffered connection implementation.

Returns:
null if this->connected() or this->getConnectionModel() != Buffered else a valid connection object is returned.

Reimplemented in RTT::Corba::CorbaPort.

template<class T >
DataObjectInterface<T>* RTT::DataPortBase< T >::data (  )  [inline, inherited]

Get the data object to write to.

The Task may use this to write to a Data Object connected to this port.

Returns:
0 if !connected(), the data object otherwise.

Definition at line 115 of file DataPort.hpp.

template<class T >
const DataObjectInterface<T>* RTT::DataPortBase< T >::data (  )  const [inline, inherited]

Get the data object to read from.

The Task may use this to read from a Data object connection connected to this port.

Returns:
0 if !connected(), the Data Object otherwise.

Definition at line 108 of file DataPort.hpp.

template<class T>
void RTT::ReadDataPort< T >::Get ( T &  result  )  [inline]

Get the current value of this Port.

Parameters:
result the variable in which the port value will be stored.
Postcondition:
result == this->data()->Get(result) if this->connected()
result is unmodified if !this->connected()

Definition at line 172 of file DataPort.hpp.

template<class T>
T RTT::ReadDataPort< T >::Get (  )  const [inline]

Get the current value of this Port.

Return values:
this->data()->Get() if this->connected()
T() if !this->connected()

Definition at line 151 of file DataPort.hpp.

bool RTT::PortInterface::setName ( const std::string &  name  )  [inherited]

Change the name of this unconnected Port.

One can only change the name when it is not yet connected.

Return values:
true if !this->connected(), the name has changed.
false if this->connected(), the name has not been changed.

The documentation for this class was generated from the following file:
Generated on Thu Dec 23 13:22:41 2010 for Orocos Real-Time Toolkit by  doxygen 1.6.3