Orocos Real-Time Toolkit  2.5.0
Public Types | Public Member Functions
RTT::base::Buffer< T > Class Template Reference

This object represents the default thread-safe buffer implementation used by Orocos objects. More...

#include <rtt/base/Buffer.hpp>

Inheritance diagram for RTT::base::Buffer< T >:
RTT::base::BufferLockFree< T > RTT::base::BufferInterface< T > RTT::base::BufferBase

List of all members.

Public Types

typedef BufferInterface< T >
::reference_t 
reference_t
typedef BufferInterface< T >
::param_t 
param_t
typedef BufferInterface< T >
::size_type 
size_type
typedef T value_t
typedef boost::shared_ptr
< BufferInterface< T > > 
shared_ptr

Public Member Functions

 Buffer (int qsize, const T &initial_value=T())
 Create a fifo queue of fixed size.
virtual void data_sample (const T &sample)
 Initializes this buffer with a data sample, such that for dynamical allocated types T, the buffer can reserve place to hold these elements.
size_type capacity () const
 Returns the maximum number of items that can be stored in the buffer.
size_type size () const
 Returns the actual number of items that are stored in the buffer.
bool empty () const
 Check if this buffer is empty.
bool full () const
 Check if this buffer is full.
void clear ()
 Clears all contents of this buffer.
bool Push (param_t item)
 Write a single value to the buffer.
size_type Push (const std::vector< T > &items)
 Write a sequence of values to the buffer.
bool Pop (reference_t item)
 Read the oldest value from the buffer.
size_type Pop (std::vector< T > &items)
 Read the whole buffer.
value_t * PopWithoutRelease ()
 Returns a pointer to the first element in the buffer.
void Release (value_t *item)
 Releases the pointer.

Detailed Description

template<class T>
class RTT::base::Buffer< T >

This object represents the default thread-safe buffer implementation used by Orocos objects.

Definition at line 67 of file Buffer.hpp.


Member Function Documentation

template<class T >
size_type RTT::base::BufferLockFree< T >::capacity ( ) const [inline, virtual, inherited]

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

Returns:
maximum number of items.

Implements RTT::base::BufferBase.

Definition at line 103 of file BufferLockFree.hpp.

References RTT::internal::AtomicMWSRQueue< T >::capacity().

template<class T >
void RTT::base::BufferLockFree< T >::clear ( ) [inline, virtual, inherited]

Clears all contents of this buffer.

Implements RTT::base::BufferBase.

Definition at line 123 of file BufferLockFree.hpp.

References RTT::internal::AtomicMWSRQueue< T >::dequeue().

template<class T >
virtual void RTT::base::BufferLockFree< T >::data_sample ( const T &  sample) [inline, virtual, inherited]

Initializes this buffer with a data sample, such that for dynamical allocated types T, the buffer can reserve place to hold these elements.

Postcondition:
Calling this function causes all data in the buffer to be lost and the size being reset to zero.

Implements RTT::base::BufferInterface< T >.

Definition at line 97 of file BufferLockFree.hpp.

References RTT::internal::TsPool< T >::data_sample().

template<class T >
bool RTT::base::BufferLockFree< T >::empty ( ) const [inline, virtual, inherited]

Check if this buffer is empty.

Returns:
true if size() == 0

Implements RTT::base::BufferBase.

Definition at line 113 of file BufferLockFree.hpp.

References RTT::internal::AtomicMWSRQueue< T >::isEmpty().

template<class T >
bool RTT::base::BufferLockFree< T >::full ( ) const [inline, virtual, inherited]

Check if this buffer is full.

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

Implements RTT::base::BufferBase.

Definition at line 118 of file BufferLockFree.hpp.

References RTT::internal::AtomicMWSRQueue< T >::isFull().

template<class T >
bool RTT::base::BufferLockFree< T >::Pop ( reference_t  item) [inline, virtual, inherited]

Read the oldest value from the buffer.

Parameters:
itemis to be set with a value from the buffer.
Returns:
true if something was read.

Implements RTT::base::BufferInterface< T >.

Definition at line 158 of file BufferLockFree.hpp.

References RTT::internal::AtomicMWSRQueue< T >::dequeue().

template<class T >
size_type RTT::base::BufferLockFree< T >::Pop ( std::vector< T > &  items) [inline, virtual, inherited]

Read the whole buffer.

Parameters:
itemsis to be filled with all values in the buffer, with items.begin() the oldest value.
Returns:
the number of items read.

Implements RTT::base::BufferInterface< T >.

Definition at line 169 of file BufferLockFree.hpp.

References RTT::internal::AtomicMWSRQueue< T >::dequeue().

template<class T >
value_t* RTT::base::BufferLockFree< T >::PopWithoutRelease ( ) [inline, virtual, inherited]

Returns a pointer to the first element in the buffer.

The pointer is only garanteed to stay valid until the next pop operation.

Note the pointer needs the be released by calling Release on the buffer.

Returns:
a pointer to a sample or Zero if buffer is empty

Implements RTT::base::BufferInterface< T >.

Definition at line 181 of file BufferLockFree.hpp.

References RTT::internal::AtomicMWSRQueue< T >::dequeue().

template<class T >
bool RTT::base::BufferLockFree< T >::Push ( param_t  item) [inline, virtual, inherited]

Write a single value to the buffer.

Parameters:
itemthe value to write
Returns:
false if the buffer is full.

Implements RTT::base::BufferInterface< T >.

Definition at line 130 of file BufferLockFree.hpp.

References RTT::internal::AtomicMWSRQueue< T >::enqueue().

Referenced by RTT::base::BufferLockFree< T >::Push().

template<class T >
size_type RTT::base::BufferLockFree< T >::Push ( const std::vector< T > &  items) [inline, virtual, inherited]

Write a sequence of values to the buffer.

Parameters:
itemsthe values to write
Returns:
the number of values written (may be less than items.size())

Implements RTT::base::BufferInterface< T >.

Definition at line 147 of file BufferLockFree.hpp.

References RTT::base::BufferLockFree< T >::Push().

template<class T >
void RTT::base::BufferLockFree< T >::Release ( value_t *  item) [inline, virtual, inherited]

Releases the pointer.

Parameters:
itempointer aquired using PopWithoutRelease()

Implements RTT::base::BufferInterface< T >.

Definition at line 189 of file BufferLockFree.hpp.

template<class T >
size_type RTT::base::BufferLockFree< T >::size ( ) const [inline, virtual, inherited]

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

Returns:
number of items.

Implements RTT::base::BufferBase.

Definition at line 108 of file BufferLockFree.hpp.

References RTT::internal::AtomicMWSRQueue< T >::size().


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