gr::buffer_reader Class Reference

How we keep track of the readers of a gr::buffer. More...

#include <gnuradio/buffer.h>

Public Member Functions
	~buffer_reader ()
void	declare_sample_delay (unsigned delay)
unsigned	sample_delay () const
int	items_available () const
	Return number of items available for reading.
buffer_sptr	buffer () const
	Return buffer this reader reads from.
int	max_possible_items_available () const
	Return maximum number of items that could ever be available for reading. This is used as a sanity check in the scheduler to avoid looping forever.
const void *	read_pointer ()
	return pointer to read buffer.
void	update_read_pointer (int nitems)
void	set_done (bool done)
bool	done () const
gr::thread::mutex *	mutex ()
uint64_t	nitems_read ()
void	reset_nitem_counter ()
size_t	get_sizeof_item ()
block_sptr	link ()
	Return the block that reads via this reader.
void	get_tags_in_range (std::vector< tag_t > &v, uint64_t abs_start, uint64_t abs_end, long id)
	Given a [start,end), returns a vector all tags in the range.

Friends
class	buffer
GR_RUNTIME_API buffer_reader_sptr	buffer_add_reader (buffer_sptr buf, int nzero_preload, block_sptr link=block_sptr(), int delay=0)
	Create a new gr::buffer_reader and attach it to buffer buf.

Detailed Description

How we keep track of the readers of a gr::buffer.

Constructor & Destructor Documentation

~buffer_reader()

gr::buffer_reader::~buffer_reader

(

)

Member Function Documentation

buffer()

buffer_sptr gr::buffer_reader::buffer ( ) const

inline

Return buffer this reader reads from.

declare_sample_delay()

void gr::buffer_reader::declare_sample_delay

(

unsigned

delay

)

Declares the sample delay for this reader.

See gr::block::declare_sample_delay for details.

Parameters

delay

The new sample delay

done()

bool gr::buffer_reader::done ( ) const

inline

Referenced by set_done().

get_sizeof_item()

size_t gr::buffer_reader::get_sizeof_item ( )

inline

get_tags_in_range()

void gr::buffer_reader::get_tags_in_range	(	std::vector< tag_t > &	v,
		uint64_t	abs_start,
		uint64_t	abs_end,
		long	id )

Given a [start,end), returns a vector all tags in the range.

Get a vector of tags in given range. Range of counts is from start to end-1.

Tags are tuples of: (item count, source id, key, value)

Parameters

v	a vector reference to return tags into
abs_start	a uint64 count of the start of the range of interest
abs_end	a uint64 count of the end of the range of interest
id	the unique ID of the block to make sure already deleted tags are not returned

items_available()

int gr::buffer_reader::items_available

(

)

const

Return number of items available for reading.

link()

block_sptr gr::buffer_reader::link ( )

inline

Return the block that reads via this reader.

Referenced by buffer_add_reader.

max_possible_items_available()

int gr::buffer_reader::max_possible_items_available ( ) const

inline

Return maximum number of items that could ever be available for reading. This is used as a sanity check in the scheduler to avoid looping forever.

mutex()

gr::thread::mutex * gr::buffer_reader::mutex ( )

inline

nitems_read()

uint64_t gr::buffer_reader::nitems_read ( )

inline

read_pointer()

const void * gr::buffer_reader::read_pointer

(

)

return pointer to read buffer.

The return value points to items_available() number of items

reset_nitem_counter()

void gr::buffer_reader::reset_nitem_counter ( )

inline

sample_delay()

unsigned gr::buffer_reader::sample_delay

(

)

const

Gets the sample delay for this reader.

See gr::block::sample_delay for details.

set_done()

void gr::buffer_reader::set_done ( bool done )

inline

References done().

update_read_pointer()

void gr::buffer_reader::update_read_pointer

(

int

nitems

)

Friends And Related Symbol Documentation

buffer

friend class buffer

friend

References buffer.

Referenced by buffer, and buffer_add_reader.

buffer_add_reader

GR_RUNTIME_API buffer_reader_sptr buffer_add_reader ( buffer_sptr buf, int nzero_preload, block_sptr link = block_sptr(), int delay = 0 )

friend

Create a new gr::buffer_reader and attach it to buffer buf.

Parameters

buf	is the buffer the gr::buffer_reader reads from.
nzero_preload	– number of zero items to "preload" into buffer.
link	is the block that reads from the buffer using this gr::buffer_reader.
delay	Optional setting to declare the buffer's sample delay.

References buffer, GR_RUNTIME_API, and link().

---

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

• buffer.h