Orocos Real-Time Toolkit
2.6.0
|
A Lock-free buffer implementation to read and write data of type T in a FIFO way. More...
#include <rtt/base/BufferLockFree.hpp>
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 | |
BufferLockFree (unsigned int bufsize, const T &initial_value=T(), bool circular=false) | |
Create a lock-free buffer wich can store bufsize elements. | |
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. | |
virtual T | data_sample () const |
Reads back a data sample. | |
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. |
A Lock-free buffer implementation to read and write data of type T in a FIFO way.
No memory allocation is done during read or write. One thread may read and any number of threads may write this buffer.
T | The value type to be stored in the Buffer. Example : BufferLockFree is a buffer which holds values of type A. |
Definition at line 68 of file BufferLockFree.hpp.
RTT::base::BufferLockFree< T >::BufferLockFree | ( | unsigned int | bufsize, |
const T & | initial_value = T() , |
||
bool | circular = false |
||
) | [inline] |
Create a lock-free buffer wich can store bufsize elements.
bufsize | the capacity of the buffer. ' |
Definition at line 87 of file BufferLockFree.hpp.
References RTT::internal::TsPool< T >::data_sample().
size_type RTT::base::BufferLockFree< T >::capacity | ( | ) | const [inline, virtual] |
Returns the maximum number of items that can be stored in the buffer.
Implements RTT::base::BufferBase.
Definition at line 115 of file BufferLockFree.hpp.
References RTT::internal::AtomicMWSRQueue< T >::capacity().
Referenced by RTT::base::BufferLockFree< T >::Push().
void RTT::base::BufferLockFree< T >::clear | ( | ) | [inline, virtual] |
Clears all contents of this buffer.
Implements RTT::base::BufferBase.
Definition at line 135 of file BufferLockFree.hpp.
References RTT::internal::AtomicMWSRQueue< T >::dequeue().
virtual void RTT::base::BufferLockFree< T >::data_sample | ( | const T & | sample | ) | [inline, virtual] |
Initializes this buffer with a data sample, such that for dynamical allocated types T, the buffer can reserve place to hold these elements.
Implements RTT::base::BufferInterface< T >.
Definition at line 98 of file BufferLockFree.hpp.
References RTT::internal::TsPool< T >::data_sample().
bool RTT::base::BufferLockFree< T >::empty | ( | ) | const [inline, virtual] |
Check if this buffer is empty.
Implements RTT::base::BufferBase.
Definition at line 125 of file BufferLockFree.hpp.
References RTT::internal::AtomicMWSRQueue< T >::isEmpty().
bool RTT::base::BufferLockFree< T >::full | ( | ) | const [inline, virtual] |
Check if this buffer is full.
Implements RTT::base::BufferBase.
Definition at line 130 of file BufferLockFree.hpp.
References RTT::internal::AtomicMWSRQueue< T >::isFull().
bool RTT::base::BufferLockFree< T >::Pop | ( | reference_t | item | ) | [inline, virtual] |
Read the oldest value from the buffer.
item | is to be set with a value from the buffer. |
Implements RTT::base::BufferInterface< T >.
Definition at line 194 of file BufferLockFree.hpp.
References RTT::internal::AtomicMWSRQueue< T >::dequeue().
size_type RTT::base::BufferLockFree< T >::Pop | ( | std::vector< T > & | items | ) | [inline, virtual] |
Read the whole buffer.
items | is to be filled with all values in the buffer, with items.begin() the oldest value. |
Implements RTT::base::BufferInterface< T >.
Definition at line 205 of file BufferLockFree.hpp.
References RTT::internal::AtomicMWSRQueue< T >::dequeue().
value_t* RTT::base::BufferLockFree< T >::PopWithoutRelease | ( | ) | [inline, virtual] |
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.
Implements RTT::base::BufferInterface< T >.
Definition at line 217 of file BufferLockFree.hpp.
References RTT::internal::AtomicMWSRQueue< T >::dequeue().
bool RTT::base::BufferLockFree< T >::Push | ( | param_t | item | ) | [inline, virtual] |
Write a single value to the buffer.
item | the value to write |
Implements RTT::base::BufferInterface< T >.
Definition at line 142 of file BufferLockFree.hpp.
References RTT::base::BufferLockFree< T >::capacity(), RTT::internal::AtomicMWSRQueue< T >::dequeue(), RTT::internal::AtomicMWSRQueue< T >::enqueue(), and RTT::internal::AtomicMWSRQueue< T >::size().
Referenced by RTT::base::BufferLockFree< T >::Push().
size_type RTT::base::BufferLockFree< T >::Push | ( | const std::vector< T > & | items | ) | [inline, virtual] |
Write a sequence of values to the buffer.
items | the values to write |
Implements RTT::base::BufferInterface< T >.
Definition at line 181 of file BufferLockFree.hpp.
References RTT::base::BufferLockFree< T >::Push().
void RTT::base::BufferLockFree< T >::Release | ( | value_t * | item | ) | [inline, virtual] |
Releases the pointer.
item | pointer aquired using PopWithoutRelease() |
Implements RTT::base::BufferInterface< T >.
Definition at line 225 of file BufferLockFree.hpp.
size_type RTT::base::BufferLockFree< T >::size | ( | ) | const [inline, virtual] |
Returns the actual number of items that are stored in the buffer.
Implements RTT::base::BufferBase.
Definition at line 120 of file BufferLockFree.hpp.
References RTT::internal::AtomicMWSRQueue< T >::size().