A class which wraps a block of data and marks whether or not it is valid. More...

#include <uhal/ValMem.hpp>

Inheritance diagram for uhal::ValVector< T >:

Collaboration diagram for uhal::ValVector< T >:

Public Types
typedef std::vector< T >::iterator	iterator
	typedef iterator to be that of the underlying storage type More...

typedef std::vector< T >::const_iterator	const_iterator
	typedef iterator to be that of the underlying storage type More...

typedef std::vector< T >::reverse_iterator	reverse_iterator
	typedef iterator to be that of the underlying storage type More...

typedef std::vector< T >::const_reverse_iterator	const_reverse_iterator
	typedef iterator to be that of the underlying storage type More...

Public Member Functions
	ValVector (const std::vector< T > &aValues)
	Constructor. More...

	ValVector (const ValVector &aValues)
	Copy Constructor. More...

	ValVector (const uint32_t &aSize)
	Constructor. More...

	ValVector ()
	Default constructor. More...

bool	valid ()
	Return whether the Validated memory is marked as valid. More...

void	valid (bool aValid)
	Change the validatity state of the Validated memory. More...

template<class InputIterator >
void	assign (InputIterator aBegin, InputIterator aEnd)
	Assignment operator - including check on whether the data has previously been marked as valid. More...

void	push_back (const T &aValue)
	If the memory has not previously been marked as valid, add an entry to the end of it. More...

const T &	operator[] (std::size_t aIndex) const
	If the memory has previously been marked as valid, give random access into memory. More...

const T &	at (std::size_t aIndex) const
	If the memory has previously been marked as valid, give random access into memory. More...

std::size_t	size () const
	Return the size of the underlying memory. More...

void	clear ()
	Clear the underlying memory and set Validity to false. More...

const_iterator	begin () const
	If the memory has previously been marked as valid, return a const iterator to the beginning of the underlying memory. More...

const_iterator	end () const
	If the memory has previously been marked as valid, return a const iterator to the end (one past last entry) of the underlying memory. More...

const_reverse_iterator	rbegin () const
	If the memory has previously been marked as valid, return a const reverse iterator to the reverse beginning (the last entry) of the underlying memory. More...

const_reverse_iterator	rend () const
	If the memory has previously been marked as valid, return a const reverse iterator to the reverse end (one before the zero'th entry) of the underlying memory. More...

std::vector< T >	value () const
	Return the value of the validated memory with check on validity. More...

void	value (const std::vector< T > &aValue)
	If the memory has not previously been marked as valid, set the value. More...

Private Attributes
boost::shared_ptr< _ValVector_< T > >	mMembers
	Return a std::deque containing all the IPbus headers returned during the transaction. More...

Friends
class	ClientInterface
	Make ClientInterface a friend so that it can access the members to get the info associated with the raw data space. More...

class	ValHeader
	Make the ValHeader class a friend so we can downcast the members. More...

Detailed Description

template<typename T>
class uhal::ValVector< T >

A class which wraps a block of data and marks whether or not it is valid.

Definition at line 76 of file ValMem.hpp.

Member Typedef Documentation

◆ const_iterator

template<typename T>

typedef std::vector< T >::const_iterator uhal::ValVector< T >::const_iterator

typedef iterator to be that of the underlying storage type

Definition at line 305 of file ValMem.hpp.

◆ const_reverse_iterator

template<typename T>

typedef std::vector< T >::const_reverse_iterator uhal::ValVector< T >::const_reverse_iterator

typedef iterator to be that of the underlying storage type

Definition at line 309 of file ValMem.hpp.

◆ iterator

template<typename T>

typedef std::vector< T >::iterator uhal::ValVector< T >::iterator

typedef iterator to be that of the underlying storage type

Definition at line 303 of file ValMem.hpp.

◆ reverse_iterator

template<typename T>

typedef std::vector< T >::reverse_iterator uhal::ValVector< T >::reverse_iterator

typedef iterator to be that of the underlying storage type

Definition at line 307 of file ValMem.hpp.

Constructor & Destructor Documentation

◆ ValVector() [1/4]

template<typename T>

uhal::ValVector< T >::ValVector ( const std::vector< T > & aValues )

Constructor.

Parameters

aValues a vector of values to which the validated memory will be initialized

Definition at line 259 of file ValMem.cpp.

◆ ValVector() [2/4]

template<typename T>

uhal::ValVector< T >::ValVector ( const ValVector< T > & aValues )

Copy Constructor.

Parameters

aValues a ValVector to copy

Definition at line 267 of file ValMem.cpp.

◆ ValVector() [3/4]

template<typename T>

uhal::ValVector< T >::ValVector ( const uint32_t & aSize )

Constructor.

Parameters

aSize the initial size of the validated memory

Definition at line 275 of file ValMem.cpp.

◆ ValVector() [4/4]

template<typename T>

uhal::ValVector< T >::ValVector ( )

Default constructor.

Definition at line 283 of file ValMem.cpp.

Member Function Documentation

◆ assign()

template<typename T >

template<class InputIterator >

void uhal::ValVector< T >::assign	(	InputIterator	aBegin,
		InputIterator	aEnd
	)

Assignment operator - including check on whether the data has previously been marked as valid.

Parameters

aBegin	Iterator to the beginning of a block of data to be copied to the Validated Memory
aEnd	Iterator to the end (one past last entry) of a block of data to be copied to the Validated Memory

Definition at line 56 of file ValMem.hxx.

◆ at()

template<typename T >

const T & uhal::ValVector< T >::at ( std::size_t aIndex ) const

If the memory has previously been marked as valid, give random access into memory.

Parameters

aIndex index of the data to be retrieved

Returns: a const reference to the data at the specified index

Definition at line 334 of file ValMem.cpp.

Referenced by uhal::tests::for(), and uhal::tests::getBlockUnitTestDepths().

◆ begin()

template<typename T >

ValVector< T >::const_iterator uhal::ValVector< T >::begin ( ) const

If the memory has previously been marked as valid, return a const iterator to the beginning of the underlying memory.

Returns: a const iterator to the beginning of the underlying memory

Definition at line 374 of file ValMem.cpp.

Referenced by uhal::tests::PerfTester::buffersEqual(), uhal::tests::PerfTester::QueuedBlockRead::check_values(), uhal::tests::for(), uhal::tests::getBlockUnitTestDepths(), uhal::tests::PerfTester::runValidationTest(), uhal::tests::PerfTester::validation_test_block_write_read(), and uhal::tests::PerfTester::validation_test_write_rmwsum_read().

◆ clear()

template<typename T >

void uhal::ValVector< T >::clear ( )

Clear the underlying memory and set Validity to false.

Definition at line 367 of file ValMem.cpp.

◆ end()

template<typename T >

ValVector< T >::const_iterator uhal::ValVector< T >::end ( ) const

If the memory has previously been marked as valid, return a const iterator to the end (one past last entry) of the underlying memory.

Returns: a const iterator to the end (one past last entry) of the underlying memory

Definition at line 389 of file ValMem.cpp.

Referenced by uhal::tests::PerfTester::buffersEqual(), uhal::tests::PerfTester::QueuedBlockRead::check_values(), uhal::tests::for(), uhal::tests::getBlockUnitTestDepths(), and uhal::tests::PerfTester::validation_test_block_write_read().

◆ operator[]()

template<typename T >

const T & uhal::ValVector< T >::operator[] ( std::size_t aIndex ) const

If the memory has previously been marked as valid, give random access into memory.

Parameters

aIndex index of the data to be retrieved

Returns: a const reference to the data at the specified index

Definition at line 319 of file ValMem.cpp.

◆ push_back()

template<typename T>

void uhal::ValVector< T >::push_back ( const T & aValue )

If the memory has not previously been marked as valid, add an entry to the end of it.

Parameters

aValue aValue to append to the block

Definition at line 304 of file ValMem.cpp.

Referenced by uhal::tests::PerfTester::runValidationTest(), and uhal::tests::PerfTester::validation_test_write_rmwsum_read().

◆ rbegin()

template<typename T >

ValVector< T >::const_reverse_iterator uhal::ValVector< T >::rbegin ( ) const

If the memory has previously been marked as valid, return a const reverse iterator to the reverse beginning (the last entry) of the underlying memory.

Returns: a const reverse iterator to the reverse beginning (the last entry) of the underlying memory

Definition at line 404 of file ValMem.cpp.

◆ rend()

template<typename T >

ValVector< T >::const_reverse_iterator uhal::ValVector< T >::rend ( ) const

If the memory has previously been marked as valid, return a const reverse iterator to the reverse end (one before the zero'th entry) of the underlying memory.

Returns: a const reverse iterator to the reverse end (one before the zero'th entry) of the underlying memory

Definition at line 419 of file ValMem.cpp.

◆ size()

template<typename T >

std::size_t uhal::ValVector< T >::size ( ) const

Return the size of the underlying memory.

Returns: the size of the underlying memory

Definition at line 349 of file ValMem.cpp.

Referenced by uhal::tests::for(), uhal::tests::getBlockUnitTestDepths(), uhal::tests::job_multiple(), and uhal::tests::UHAL_TESTS_DEFINE_CLIENT_TEST_CASES().

◆ valid() [1/2]

template<typename T >

bool uhal::ValVector< T >::valid ( )

Return whether the Validated memory is marked as valid.

Returns: whether the Validated memory is marked as valid

Definition at line 290 of file ValMem.cpp.

Referenced by uhal::ValVector< uint32_t >::clear(), uhal::tests::for(), uhal::tests::getBlockUnitTestDepths(), uhal::tests::job_multiple(), uhal::tests::UHAL_TESTS_DEFINE_CLIENT_TEST_CASES(), and uhal::ValVector< uint32_t >::valid().

◆ valid() [2/2]

template<typename T >

void uhal::ValVector< T >::valid ( bool aValid )

Change the validatity state of the Validated memory.

Parameters

aValid the new validity state of the Validated memory

Definition at line 296 of file ValMem.cpp.

◆ value() [1/2]

template<typename T >

std::vector< T > uhal::ValVector< T >::value ( ) const

Return the value of the validated memory with check on validity.

Returns: the value of the validated memory

Definition at line 435 of file ValMem.cpp.

Referenced by uhal::ValVector< uint32_t >::at(), uhal::ValVector< uint32_t >::begin(), uhal::ValVector< uint32_t >::end(), uhal::tests::for(), uhal::tests::getBlockUnitTestDepths(), uhal::ValVector< uint32_t >::rbegin(), uhal::ValVector< uint32_t >::rend(), uhal::ValVector< uint32_t >::size(), and uhal::ValVector< uint32_t >::value().

◆ value() [2/2]

template<typename T>

void uhal::ValVector< T >::value ( const std::vector< T > & aValue )

If the memory has not previously been marked as valid, set the value.

Parameters

aValue the value of the validated memory

Definition at line 450 of file ValMem.cpp.

Friends And Related Function Documentation

◆ ClientInterface

template<typename T>

friend class ClientInterface

friend

Make ClientInterface a friend so that it can access the members to get the info associated with the raw data space.

Definition at line 296 of file ValMem.hpp.

◆ ValHeader

template<typename T>

friend class ValHeader

friend

Make the ValHeader class a friend so we can downcast the members.

Definition at line 299 of file ValMem.hpp.

Member Data Documentation

◆ mMembers

template<typename T>

boost::shared_ptr< _ValVector_<T> > uhal::ValVector< T >::mMembers

private

Return a std::deque containing all the IPbus headers returned during the transaction.

Returns: a std::deque containing all the IPbus headers returned during the transaction

Note: This is a deque, since a block transaction may be chunked into many smaller block transactionsA shared pointer to a ValVector struct, so that every copy of this ValVector points to the same underlying memory

Definition at line 436 of file ValMem.hpp.

Referenced by uhal::ClientInterface::CreateValVector().

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

uhal/include/uhal/ValMem.hpp
uhal/include/uhal/TemplateDefinitions/ValMem.hxx
uhal/src/common/ValMem.cpp

Public Types

Public Member Functions

Private Attributes

Friends

Detailed Description

template<typename T> class uhal::ValVector< T >

Member Typedef Documentation

◆ const_iterator

◆ const_reverse_iterator

◆ iterator

◆ reverse_iterator

Constructor & Destructor Documentation

◆ ValVector() [1/4]

◆ ValVector() [2/4]

◆ ValVector() [3/4]

◆ ValVector() [4/4]

Member Function Documentation

◆ assign()

◆ at()

◆ begin()

◆ clear()

◆ end()

◆ operator[]()

◆ push_back()

◆ rbegin()

◆ rend()

◆ size()

◆ valid() [1/2]

◆ valid() [2/2]

◆ value() [1/2]

◆ value() [2/2]

Friends And Related Function Documentation

◆ ClientInterface

◆ ValHeader

Member Data Documentation

◆ mMembers

template<typename T>
class uhal::ValVector< T >