ReadDataPort Class Template Reference
[Data Transfer Ports]

#include <rtt/DataPort.hpp>

Inherits RTT::DataPortBase< T >.

List of all members.


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 130 of file DataPort.hpp.


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.

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

Friends

class ConnectionInterface

Constructor & Destructor Documentation

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 142 of file DataPort.hpp.


Member Function Documentation

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 149 of file DataPort.hpp.

void 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 170 of file DataPort.hpp.

ConnectionInterface::shared_ptr 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 CorbaPort.

Definition at line 187 of file PortInterface.cpp.

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

Definition at line 71 of file PortInterface.cpp.

References PortInterface::antiClone(), PortInterface::connect(), PortInterface::connection(), PortInterface::connectTo(), PortInterface::createConnection(), PortInterface::disconnect(), PortInterface::getPortType(), PortInterface::ready(), and PortInterface::serverProtocol().

const DataObjectInterface<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 106 of file DataPort.hpp.

DataObjectInterface<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 113 of file DataPort.hpp.

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

Definition at line 50 of file PortInterface.cpp.

References PortInterface::connected().


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

Generated on Mon Jan 19 16:53:57 2009 for OrocosReal-TimeToolkit by  doxygen 1.5.6