eformat::PagedMemory< TMAXPAGES >::const_iterator Class Reference

#include <PagedMemory.h>

Public Member Functions
	const_iterator ()
	const_iterator (const const_iterator &other)
	~const_iterator ()
const_iterator &	operator= (const const_iterator &other)
bool	operator!= (const const_iterator &other) const
bool	operator== (const const_iterator &other) const
uint32_t	operator[] (size_t pos) const
uint32_t	at (size_t pos) const
uint32_t	operator* (void) const
const_iterator &	operator++ (void)
const_iterator &	operator-- ()
const_iterator &	operator+= (size_t offset)
const_iterator &	operator-= (size_t offset)
bool	operator< (const const_iterator &other) const
bool	operator> (const const_iterator &other) const
int32_t	operator- (const const_iterator &other) const
	const_iterator ()
	const_iterator (const const_iterator &other)
	~const_iterator ()
const_iterator &	operator= (const const_iterator &other)
bool	operator!= (const const_iterator &other) const
bool	operator== (const const_iterator &other) const
uint32_t	operator[] (size_t pos) const
uint32_t	at (size_t pos) const
uint32_t	operator* (void) const
const_iterator &	operator++ (void)
const_iterator &	operator-- ()
const_iterator &	operator+= (size_t offset)
const_iterator &	operator-= (size_t offset)
bool	operator< (const const_iterator &other) const
bool	operator> (const const_iterator &other) const
int32_t	operator- (const const_iterator &other) const
	const_iterator ()
	const_iterator (const const_iterator &other)
	~const_iterator ()
const_iterator &	operator= (const const_iterator &other)
bool	operator!= (const const_iterator &other) const
bool	operator== (const const_iterator &other) const
uint32_t	operator[] (size_t pos) const
uint32_t	at (size_t pos) const
uint32_t	operator* (void) const
const_iterator &	operator++ (void)
const_iterator &	operator-- ()
const_iterator &	operator+= (size_t offset)
const_iterator &	operator-= (size_t offset)
bool	operator< (const const_iterator &other) const
bool	operator> (const const_iterator &other) const
int32_t	operator- (const const_iterator &other) const

Friends
class	PagedMemory

Detailed Description

template<unsigned int TMAXPAGES = 128>
class eformat::PagedMemory< TMAXPAGES >::const_iterator

Defines an iterator-like type for this type of memory. There are no guarantees on the iteration. The user should test and only iterate from begin() till end()

Definition at line 97 of file Event/eformat/include/eformat/PagedMemory.h.

Constructor & Destructor Documentation

const_iterator() [1/6]

template<unsigned int TMAXPAGES = 128>

eformat::PagedMemory< TMAXPAGES >::const_iterator::const_iterator ( )

inline

Returns an iterator that points nowhere, to fake similar behaviour as the normal pointers.

Definition at line 117 of file Event/eformat/include/eformat/PagedMemory.h.

: m_node(), m_off() {}

const_iterator() [2/6]

template<unsigned int TMAXPAGES = 128>

eformat::PagedMemory< TMAXPAGES >::const_iterator::const_iterator ( const const_iterator & other )

inline

Copies the value of an iterator

Parameters

other

The iterator to copy the data from

Definition at line 124 of file Event/eformat/include/eformat/PagedMemory.h.

          : m_node( other.m_node ), m_off( other.m_off ) {}

~const_iterator() [1/3]

template<unsigned int TMAXPAGES = 128>

eformat::PagedMemory< TMAXPAGES >::const_iterator::~const_iterator ( )

inline

Destroys an iterator

Definition at line 130 of file Event/eformat/include/eformat/PagedMemory.h.

{}

const_iterator() [3/6]

template<unsigned int TMAXPAGES = 128>

eformat::PagedMemory< TMAXPAGES >::const_iterator::const_iterator ( )

inline

Returns an iterator that points nowhere, to fake similar behaviour as the normal pointers.

Definition at line 117 of file InstallArea/x86_64-el9-gcc13-dbg/include/eformat/PagedMemory.h.

: m_node(), m_off() {}

const_iterator() [4/6]

template<unsigned int TMAXPAGES = 128>

eformat::PagedMemory< TMAXPAGES >::const_iterator::const_iterator ( const const_iterator & other )

inline

Copies the value of an iterator

Parameters

other

The iterator to copy the data from

Definition at line 124 of file InstallArea/x86_64-el9-gcc13-dbg/include/eformat/PagedMemory.h.

          : m_node( other.m_node ), m_off( other.m_off ) {}

~const_iterator() [2/3]

template<unsigned int TMAXPAGES = 128>

eformat::PagedMemory< TMAXPAGES >::const_iterator::~const_iterator ( )

inline

Destroys an iterator

Definition at line 130 of file InstallArea/x86_64-el9-gcc13-dbg/include/eformat/PagedMemory.h.

{}

const_iterator() [5/6]

template<unsigned int TMAXPAGES = 128>

eformat::PagedMemory< TMAXPAGES >::const_iterator::const_iterator ( )

inline

Returns an iterator that points nowhere, to fake similar behaviour as the normal pointers.

Definition at line 117 of file InstallArea/x86_64-el9-gcc13-opt/include/eformat/PagedMemory.h.

: m_node(), m_off() {}

const_iterator() [6/6]

template<unsigned int TMAXPAGES = 128>

eformat::PagedMemory< TMAXPAGES >::const_iterator::const_iterator ( const const_iterator & other )

inline

Copies the value of an iterator

Parameters

other

The iterator to copy the data from

Definition at line 124 of file InstallArea/x86_64-el9-gcc13-opt/include/eformat/PagedMemory.h.

          : m_node( other.m_node ), m_off( other.m_off ) {}

~const_iterator() [3/3]

template<unsigned int TMAXPAGES = 128>

eformat::PagedMemory< TMAXPAGES >::const_iterator::~const_iterator ( )

inline

Destroys an iterator

Definition at line 130 of file InstallArea/x86_64-el9-gcc13-opt/include/eformat/PagedMemory.h.

{}

Member Function Documentation

at() [1/3]

template<unsigned int TMAXPAGES>

uint32_t eformat::PagedMemory< TMAXPAGES >::const_iterator::at

(

size_t

pos

)

const

Gets a value away N positions from this iterator, checked and may throw an exception

Parameters

pos	The number "N" of positions away from this iterator

Definition at line 320 of file Event/eformat/include/eformat/PagedMemory.h.

                                                                           {
  // immediate return (most of the cases)
  if ( m_off + pos < m_node->end )
  { // trying to reach data on the current page
    return CAST32( m_node->page->iov_base )[( m_off + pos ) - m_node->start];
  }
 
  // immediate points of failure
  if ( !m_node || ( m_node->next == 0 && ( m_off + pos ) >= m_node->end ) )
    throw EFORMAT_OUT_OF_BOUNDS( 0, pos << 2 );
 
  // if I get here, the data is on another page and the request might still be
  // out of bounds, so watch.
  const_iterator it = *this;
  it += pos;
  return it.at( 0 );
}

Referenced by at().

at() [2/3]

template<unsigned int TMAXPAGES = 128>

uint32_t eformat::PagedMemory< TMAXPAGES >::const_iterator::at

(

size_t

pos

)

const

Gets a value away N positions from this iterator, checked and may throw an exception

Parameters

pos	The number "N" of positions away from this iterator

at() [3/3]

template<unsigned int TMAXPAGES = 128>

uint32_t eformat::PagedMemory< TMAXPAGES >::const_iterator::at

(

size_t

pos

)

const

Gets a value away N positions from this iterator, checked and may throw an exception

Parameters

pos	The number "N" of positions away from this iterator

operator!=() [1/3]

template<unsigned int TMAXPAGES = 128>

bool eformat::PagedMemory< TMAXPAGES >::const_iterator::operator!=

(

const const_iterator &

other

)

const

Compares two pointers

Parameters

other

The other iterator to compare this one with.

operator!=() [2/3]

template<unsigned int TMAXPAGES = 128>

bool eformat::PagedMemory< TMAXPAGES >::const_iterator::operator!=

(

const const_iterator &

other

)

const

Compares two pointers

Parameters

other

The other iterator to compare this one with.

operator!=() [3/3]

template<unsigned int TMAXPAGES = 128>

bool eformat::PagedMemory< TMAXPAGES >::const_iterator::operator!=

(

const const_iterator &

other

)

const

Compares two pointers

Parameters

other

The other iterator to compare this one with.

operator*() [1/3]

template<unsigned int TMAXPAGES = 128>

uint32_t eformat::PagedMemory< TMAXPAGES >::const_iterator::operator* ( void ) const

inline

Gets the current value for the pointed position, as a 32-bit integer. This is unchecked so you have to make sure you are before end().

Definition at line 175 of file Event/eformat/include/eformat/PagedMemory.h.

                                              {
        return CAST32( m_node->page->iov_base )[m_off - m_node->start];
      }

operator*() [2/3]

template<unsigned int TMAXPAGES = 128>

uint32_t eformat::PagedMemory< TMAXPAGES >::const_iterator::operator* ( void ) const

inline

Gets the current value for the pointed position, as a 32-bit integer. This is unchecked so you have to make sure you are before end().

Definition at line 175 of file InstallArea/x86_64-el9-gcc13-dbg/include/eformat/PagedMemory.h.

                                              {
        return CAST32( m_node->page->iov_base )[m_off - m_node->start];
      }

operator*() [3/3]

template<unsigned int TMAXPAGES = 128>

uint32_t eformat::PagedMemory< TMAXPAGES >::const_iterator::operator* ( void ) const

inline

Gets the current value for the pointed position, as a 32-bit integer. This is unchecked so you have to make sure you are before end().

Definition at line 175 of file InstallArea/x86_64-el9-gcc13-opt/include/eformat/PagedMemory.h.

                                              {
        return CAST32( m_node->page->iov_base )[m_off - m_node->start];
      }

operator++() [1/3]

template<unsigned int TMAXPAGES>

eformat::PagedMemory< TMAXPAGES >::const_iterator & eformat::PagedMemory< TMAXPAGES >::const_iterator::operator++

(

void

)

Advances forward on the pointing place, 4 bytes or 1 word. This is the prefix operator.

Definition at line 340 of file Event/eformat/include/eformat/PagedMemory.h.

                                                              {
  ++m_off;
  if ( m_off >= ( m_node->end ) )
  {
    if ( !m_node->next )
    { // it was the last
      m_off = m_node->end;
      return *this;
    }
    m_node = m_node->next;
    m_off  = m_node->start;
  }
  return *this;
}

operator++() [2/3]

template<unsigned int TMAXPAGES = 128>

const_iterator & eformat::PagedMemory< TMAXPAGES >::const_iterator::operator++

(

void

)

Advances forward on the pointing place, 4 bytes or 1 word. This is the prefix operator.

operator++() [3/3]

template<unsigned int TMAXPAGES = 128>

const_iterator & eformat::PagedMemory< TMAXPAGES >::const_iterator::operator++

(

void

)

Advances forward on the pointing place, 4 bytes or 1 word. This is the prefix operator.

operator+=() [1/3]

template<unsigned int TMAXPAGES>

eformat::PagedMemory< TMAXPAGES >::const_iterator & eformat::PagedMemory< TMAXPAGES >::const_iterator::operator+=

(

size_t

offset

)

Advances forward on the pointing place, by a number of (32-bit) words

Parameters

offset

The amount of words to advance

Definition at line 374 of file Event/eformat/include/eformat/PagedMemory.h.

                                                                     {
  size_t aim = offset + m_off;
  while ( aim >= ( m_node->end ) )
  {
    if ( m_node->next ) m_node = m_node->next;
    else
    { // it was the last
      m_off = m_node->end;
      return *this;
    }
  }
  m_off = aim;
  return *this;
}

operator+=() [2/3]

template<unsigned int TMAXPAGES = 128>

const_iterator & eformat::PagedMemory< TMAXPAGES >::const_iterator::operator+=

(

size_t

offset

)

Advances forward on the pointing place, by a number of (32-bit) words

Parameters

offset

The amount of words to advance

operator+=() [3/3]

template<unsigned int TMAXPAGES = 128>

const_iterator & eformat::PagedMemory< TMAXPAGES >::const_iterator::operator+=

(

size_t

offset

)

Advances forward on the pointing place, by a number of (32-bit) words

Parameters

offset

The amount of words to advance

operator-() [1/3]

template<unsigned int TMAXPAGES = 128>

int32_t eformat::PagedMemory< TMAXPAGES >::const_iterator::operator- ( const const_iterator & other ) const

inline

Returns the difference in position between two iterators

Parameters

other

The other iterator to compare to

Definition at line 228 of file Event/eformat/include/eformat/PagedMemory.h.

                                                                    {
        return (int32_t)m_off - (int32_t)other.m_off;
      }

operator-() [2/3]

template<unsigned int TMAXPAGES = 128>

int32_t eformat::PagedMemory< TMAXPAGES >::const_iterator::operator- ( const const_iterator & other ) const

inline

Returns the difference in position between two iterators

Parameters

other

The other iterator to compare to

Definition at line 228 of file InstallArea/x86_64-el9-gcc13-dbg/include/eformat/PagedMemory.h.

                                                                    {
        return (int32_t)m_off - (int32_t)other.m_off;
      }

operator-() [3/3]

template<unsigned int TMAXPAGES = 128>

int32_t eformat::PagedMemory< TMAXPAGES >::const_iterator::operator- ( const const_iterator & other ) const

inline

Returns the difference in position between two iterators

Parameters

other

The other iterator to compare to

Definition at line 228 of file InstallArea/x86_64-el9-gcc13-opt/include/eformat/PagedMemory.h.

                                                                    {
        return (int32_t)m_off - (int32_t)other.m_off;
      }

operator--() [1/3]

template<unsigned int TMAXPAGES>

eformat::PagedMemory< TMAXPAGES >::const_iterator & eformat::PagedMemory< TMAXPAGES >::const_iterator::operator--

(

void

)

Step back on the pointing place, 4 bytes or 1 word. This is the prefix operator.

Definition at line 357 of file Event/eformat/include/eformat/PagedMemory.h.

                                                              {
  --m_off;
  if ( m_off < ( m_node->start ) )
  {
    if ( !m_node->previous )
    { // it was the last
      m_off = m_node->start;
      return *this;
    }
    m_node = m_node->previous;
    m_off  = m_node->end - 1;
  }
  return *this;
}

operator--() [2/3]

template<unsigned int TMAXPAGES = 128>

const_iterator & eformat::PagedMemory< TMAXPAGES >::const_iterator::operator--

(

)

Step back on the pointing place, 4 bytes or 1 word. This is the prefix operator.

operator--() [3/3]

template<unsigned int TMAXPAGES = 128>

const_iterator & eformat::PagedMemory< TMAXPAGES >::const_iterator::operator--

(

)

Step back on the pointing place, 4 bytes or 1 word. This is the prefix operator.

operator-=() [1/3]

template<unsigned int TMAXPAGES>

eformat::PagedMemory< TMAXPAGES >::const_iterator & eformat::PagedMemory< TMAXPAGES >::const_iterator::operator-=

(

size_t

offset

)

Retrocesses on the pointing place, by a number of (32-bit) words

Parameters

offset

The amount of words to advance

Definition at line 391 of file Event/eformat/include/eformat/PagedMemory.h.

                                                                     {
  size_t aim = m_off - offset;
  while ( aim < ( m_node->start ) )
  {
    if ( m_node->previous ) m_node = m_node->previous;
    else
    { // it was the first
      m_off = m_node->start;
      return *this;
    }
  }
  m_off = aim;
  return *this;
}

operator-=() [2/3]

template<unsigned int TMAXPAGES = 128>

const_iterator & eformat::PagedMemory< TMAXPAGES >::const_iterator::operator-=

(

size_t

offset

)

Retrocesses on the pointing place, by a number of (32-bit) words

Parameters

offset

The amount of words to advance

operator-=() [3/3]

template<unsigned int TMAXPAGES = 128>

const_iterator & eformat::PagedMemory< TMAXPAGES >::const_iterator::operator-=

(

size_t

offset

)

Retrocesses on the pointing place, by a number of (32-bit) words

Parameters

offset

The amount of words to advance

operator<() [1/3]

template<unsigned int TMAXPAGES = 128>

bool eformat::PagedMemory< TMAXPAGES >::const_iterator::operator< ( const const_iterator & other ) const

inline

Compares two operators (offset comparison)

Parameters

other

The other iterator to compare to

Definition at line 210 of file Event/eformat/include/eformat/PagedMemory.h.

                                                                 {
        return m_off < other.m_off;
      }

operator<() [2/3]

template<unsigned int TMAXPAGES = 128>

bool eformat::PagedMemory< TMAXPAGES >::const_iterator::operator< ( const const_iterator & other ) const

inline

Compares two operators (offset comparison)

Parameters

other

The other iterator to compare to

Definition at line 210 of file InstallArea/x86_64-el9-gcc13-dbg/include/eformat/PagedMemory.h.

                                                                 {
        return m_off < other.m_off;
      }

operator<() [3/3]

template<unsigned int TMAXPAGES = 128>

bool eformat::PagedMemory< TMAXPAGES >::const_iterator::operator< ( const const_iterator & other ) const

inline

Compares two operators (offset comparison)

Parameters

other

The other iterator to compare to

Definition at line 210 of file InstallArea/x86_64-el9-gcc13-opt/include/eformat/PagedMemory.h.

                                                                 {
        return m_off < other.m_off;
      }

operator=() [1/3]

template<unsigned int TMAXPAGES = 128>

const_iterator & eformat::PagedMemory< TMAXPAGES >::const_iterator::operator=

(

const const_iterator &

other

)

Copies the value of an iterator

Parameters

other

The iterator to copy the data from

operator=() [2/3]

template<unsigned int TMAXPAGES = 128>

const_iterator & eformat::PagedMemory< TMAXPAGES >::const_iterator::operator=

(

const const_iterator &

other

)

Copies the value of an iterator

Parameters

other

The iterator to copy the data from

operator=() [3/3]

template<unsigned int TMAXPAGES = 128>

const_iterator & eformat::PagedMemory< TMAXPAGES >::const_iterator::operator=

(

const const_iterator &

other

)

Copies the value of an iterator

Parameters

other

The iterator to copy the data from

operator==() [1/3]

template<unsigned int TMAXPAGES = 128>

bool eformat::PagedMemory< TMAXPAGES >::const_iterator::operator== ( const const_iterator & other ) const

inline

Compares two pointers

Parameters

other

The other iterator to compare this one with.

Definition at line 151 of file Event/eformat/include/eformat/PagedMemory.h.

                                                                {
        return !( *this != other );
      }

operator==() [2/3]

template<unsigned int TMAXPAGES = 128>

bool eformat::PagedMemory< TMAXPAGES >::const_iterator::operator== ( const const_iterator & other ) const

inline

Compares two pointers

Parameters

other

The other iterator to compare this one with.

Definition at line 151 of file InstallArea/x86_64-el9-gcc13-dbg/include/eformat/PagedMemory.h.

                                                                {
        return !( *this != other );
      }

operator==() [3/3]

template<unsigned int TMAXPAGES = 128>

bool eformat::PagedMemory< TMAXPAGES >::const_iterator::operator== ( const const_iterator & other ) const

inline

Compares two pointers

Parameters

other

The other iterator to compare this one with.

Definition at line 151 of file InstallArea/x86_64-el9-gcc13-opt/include/eformat/PagedMemory.h.

                                                                {
        return !( *this != other );
      }

operator>() [1/3]

template<unsigned int TMAXPAGES = 128>

bool eformat::PagedMemory< TMAXPAGES >::const_iterator::operator> ( const const_iterator & other ) const

inline

Compares two operators (offset comparison)

Parameters

other

The other iterator to compare to

Definition at line 219 of file Event/eformat/include/eformat/PagedMemory.h.

                                                                 {
        return m_off > other.m_off;
      }

operator>() [2/3]

template<unsigned int TMAXPAGES = 128>

bool eformat::PagedMemory< TMAXPAGES >::const_iterator::operator> ( const const_iterator & other ) const

inline

Compares two operators (offset comparison)

Parameters

other

The other iterator to compare to

Definition at line 219 of file InstallArea/x86_64-el9-gcc13-dbg/include/eformat/PagedMemory.h.

                                                                 {
        return m_off > other.m_off;
      }

operator>() [3/3]

template<unsigned int TMAXPAGES = 128>

bool eformat::PagedMemory< TMAXPAGES >::const_iterator::operator> ( const const_iterator & other ) const

inline

Compares two operators (offset comparison)

Parameters

other

The other iterator to compare to

Definition at line 219 of file InstallArea/x86_64-el9-gcc13-opt/include/eformat/PagedMemory.h.

                                                                 {
        return m_off > other.m_off;
      }

operator[]() [1/3]

template<unsigned int TMAXPAGES>

uint32_t eformat::PagedMemory< TMAXPAGES >::const_iterator::operator[]

(

size_t

pos

)

const

Gets a value away N positions from this iterator, unchecked

Parameters

pos	The number "N" of positions away from this iterator

Definition at line 308 of file Event/eformat/include/eformat/PagedMemory.h.

                                                                                   {
  if ( m_off + pos < m_node->end )
  { // trying to reach data on the current page
    return CAST32( m_node->page->iov_base )[( m_off + pos ) - m_node->start];
  }
  // otherwise it is not on this page, I have to find the page
  const_iterator it = *this;
  it += pos;
  return *it;
}

operator[]() [2/3]

template<unsigned int TMAXPAGES = 128>

uint32_t eformat::PagedMemory< TMAXPAGES >::const_iterator::operator[]

(

size_t

pos

)

const

Gets a value away N positions from this iterator, unchecked

Parameters

pos	The number "N" of positions away from this iterator

operator[]() [3/3]

template<unsigned int TMAXPAGES = 128>

uint32_t eformat::PagedMemory< TMAXPAGES >::const_iterator::operator[]

(

size_t

pos

)

const

Gets a value away N positions from this iterator, unchecked

Parameters

pos	The number "N" of positions away from this iterator

Friends And Related Symbol Documentation

PagedMemory

template<unsigned int TMAXPAGES = 128>

PagedMemory

friend

Definition at line 100 of file Event/eformat/include/eformat/PagedMemory.h.

Referenced by PagedMemory.

---

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

• Event/eformat/include/eformat/PagedMemory.h
• InstallArea/x86_64-el9-gcc13-dbg/include/eformat/PagedMemory.h
• InstallArea/x86_64-el9-gcc13-opt/include/eformat/PagedMemory.h