WriteBufferPort Class Template Reference
[Data Transfer Ports]

#include </home/sspr/src/www/orocos-1.0/export/build/orocos-rtt-1.2.2/build/rtt/BufferPort.hpp>

Inheritance diagram for WriteBufferPort:

PortInterface BufferPort List of all members.

Detailed Description

template<class T>
class RTT::WriteBufferPort< T >

A Port to a writable 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.


Public Types

enum  PortType { ReadPort, WritePort, ReadWritePort }
 This enum classifies if a port is inbound outbound or both.

Public Member Functions

 WriteBufferPort (const std::string &name, size_t preferred_size, const T &initial_value=T())
 Construct an unconnected Port to a writeable buffer.
void setBufferSize (size_t b_size)
 Set the prefered buffersize before this port is connected.
bool Push (const T &data)
 Push a value into the buffer of this Port's connection.
void Set (const T &data)
 Set the initial value of the port's connection.
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.
bool connected () const
 Inspect if this Port is currently connected with another Port.
virtual bool connect (typename WriteConnectionInterface< T >::shared_ptr conn)
 Connect a writeable buffer to this Port.
bool connectTo (ConnectionInterface::shared_ptr other)
 Connect this port to a Connection.
void disconnect ()
 No longer participate in a connection.
virtual WriteInterface< T > * write () const
 Get the buffer to write to.
virtual ConnectionInterface::shared_ptr connection () const
 Returns the connection in which this Port currently participates.
virtual PortType getPortType () const
 Get the PortType of this port.
WriteBufferPortoperator= (BufferInterface< T > *impl)
 Provide a new implementation for the connection of this port.
ConnectionInterface::shared_ptr createConnection (PortInterface *other, ConnectionTypes::ConnectionType con_type=ConnectionTypes::lockfree)
 Create a connection object from this port to another port.
ConnectionInterface::shared_ptr createConnection (ConnectionTypes::ConnectionType con_type=ConnectionTypes::lockfree)
 Create a new connection object to which this port is subscribed.
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.
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 bool connectTo (PortInterface *other)
 Connect to another Port and create a new connection if necessary.

Protected Attributes

WriteConnectionInterface<
T >::shared_ptr 
mconn
 The buffer to write from.
size_t buf_size
minitial_value
std::string portname


Constructor & Destructor Documentation

WriteBufferPort ( const std::string &  name,
size_t  preferred_size,
const T &  initial_value = T() 
) [inline]

Construct an unconnected Port to a writeable buffer.

Parameters:
name The name of this port.
initial_value The initial value of this port's connection when the connection is created. If this port is connected to an existing connection, this value is ignored.


Member Function Documentation

void setBufferSize ( size_t  b_size  )  [inline]

Set the prefered buffersize before this port is connected.

If this->connected(), this value has no effect.

bool Push ( const T &  data  )  [inline]

Push a value into the buffer of this Port's connection.

Parameters:
data The data to push.
Return values:
this->read()->Push(data) if this->connected()
false if !this->connected()

void Set ( const T &  data  )  [inline]

Set the initial value of the port's connection.

This value is only used when the connection is created. If this port is connected to an existing connection, the value is ignored.

BufferBase::size_type size (  )  const [inline]

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

Returns:
number of items.

Reimplemented in BufferPort.

BufferBase::size_type capacity (  )  const [inline]

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

Returns:
maximum number of items.

Reimplemented in BufferPort.

bool empty (  )  const [inline]

Check if this buffer is empty.

Returns:
true if size() == 0

Reimplemented in BufferPort.

bool full (  )  const [inline]

Check if this buffer is full.

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

Reimplemented in BufferPort.

bool connectTo ( ConnectionInterface::shared_ptr  other  )  [inline, virtual]

Connect this port to a Connection.

If the connection is in the connected() state, this port will participate in that connection, otherwise, the port will become connected once conn becomes connected().

Returns:
true if connection was possible, false otherwise.

Implements PortInterface.

Reimplemented in BufferPort.

virtual WriteInterface<T>* write (  )  const [inline, virtual]

Get the buffer to write to.

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

virtual ConnectionInterface::shared_ptr connection (  )  const [inline, virtual]

Returns the connection in which this Port currently participates.

It is possible that this port is part of a dormant connection, ( the connection object is not in the connected() state), in that case this method will return null, until the dormant connection becomes connected().

Return values:
null if not connected to another Port.

Implements PortInterface.

Reimplemented in BufferPort.

WriteBufferPort< T > & operator= ( BufferInterface< T > *  impl  ) 

Provide a new implementation for the connection of this port.

If this port is not connected, a new connection is created.

Reimplemented in BufferPort.

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.

bool ready (  )  const [inherited]

Returns true if this Port is ready to be used.

Identical to connected().

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

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


The documentation for this class was generated from the following file:
Generated on Fri Oct 19 16:27:21 2007 for Orocos by  doxygen 1.5.1