ReadBufferPort Class Template Reference
[Data Transfer Ports]

#include <rtt/BufferPort.hpp>

Inherits RTT::BufferPortBase< T >.

List of all members.


Detailed Description

template<class T>
class RTT::ReadBufferPort< T >

A Port to a readable Buffer.

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

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

Definition at line 237 of file BufferPort.hpp.


Public Types

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

 ReadBufferPort (const std::string &name)
 Construct an unconnected Port to a readable buffer.
bool Pop (T &data)
 Pop a value from the buffer of this Port's connection.
front () const
 Get the next value to be Pop()'ed, or the default value if empty.
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
 The anti-Clone of a ReadBufferPort is a WriteBufferPort with prefered buffer size '1'.
virtual TaskObjectcreatePortObject ()
 Create accessor Object for this Port, for addition to a TaskContext Object interface.
void clear ()
 Clears all contents of this buffer.
BufferBase::size_type size () const
 Returns the actual number of items that are stored in the buffer.
BufferBase::size_type capacity () const
 Returns the maximum number of items that can be stored in the buffer.
bool empty () const
 Check if this buffer is empty.
bool full () const
 Check if this buffer is full.
virtual ConnectionModel getConnectionModel () const
virtual const TypeInfogetTypeInfo () const
bool connected () const
void disconnect ()
bool connectTo (ConnectionInterface::shared_ptr other)
virtual bool connectTo (PortInterface *other)
 Connect to another Port and create a new connection if necessary.
virtual BufferInterface< T > * buffer ()
 Get the buffer to read from or write to.
virtual const BufferInterface
< T > * 
buffer () const
virtual
ConnectionInterface::shared_ptr 
connection () const
ConnectionInterface::shared_ptr createConnection (BufferBase::shared_ptr impl)
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 (DataSourceBase::shared_ptr data)
 Create a new connection object using a data connection implementation.
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 Member Functions

virtual bool connect (typename ConnectionInterface::shared_ptr conn)
 Connect a readable buffer to this Port.

Protected Attributes

BufferConnection< T >::shared_ptr mconn
std::string portname

Friends

class ConnectionInterface

Constructor & Destructor Documentation

ReadBufferPort ( const std::string &  name  )  [inline]

Construct an unconnected Port to a readable buffer.

Parameters:
name The name of this port.

Definition at line 248 of file BufferPort.hpp.


Member Function Documentation

bool Pop ( T &  data  )  [inline]

Pop a value from the buffer of this Port's connection.

Parameters:
data The location where to store the popped value.
Return values:
this->buffer()->Pop(data) if this->connected()
false if !this->connected()

Definition at line 256 of file BufferPort.hpp.

BufferBase::size_type size (  )  const [inline, inherited]

Returns the actual number of items that are stored in the buffer.

Returns:
number of items.

Definition at line 100 of file BufferPort.hpp.

BufferBase::size_type capacity (  )  const [inline, inherited]

Returns the maximum number of items that can be stored in the buffer.

Returns:
maximum number of items.

Definition at line 119 of file BufferPort.hpp.

bool empty (  )  const [inline, inherited]

Check if this buffer is empty.

Returns:
true if size() == 0

Definition at line 137 of file BufferPort.hpp.

bool full (  )  const [inline, inherited]

Check if this buffer is full.

Returns:
true if size() == capacity()

Definition at line 155 of file BufferPort.hpp.

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

virtual BufferInterface<T>* buffer (  )  [inline, virtual, inherited]

Get the buffer to read from or write to.

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

Definition at line 194 of file BufferPort.hpp.

ConnectionInterface::shared_ptr createConnection ( DataSourceBase::shared_ptr  data  )  [virtual, inherited]

Create a new connection object using a data connection implementation.

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

Reimplemented in CorbaPort.

Definition at line 192 of file PortInterface.cpp.

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:56 2009 for OrocosReal-TimeToolkit by  doxygen 1.5.6