Skip to content

iox::cxx::list::IteratorBase🔗

nested iterator class for list element operations including element access comparison of iterator from different list is rejected by terminate() More...

Public Types🔗

Name
using std::bidirectional_iterator_tag iterator_category
using typename std::conditional< IsConstIterator, const T, T >::type value_type
using void difference_type
using typename std::conditional< IsConstIterator, const T *, T * >::type pointer
using typename std::conditional< IsConstIterator, const T &, T & >::type reference

Public Functions🔗

Name
IteratorBase(const IteratorBase< false > & iter)
construct a const_iterator from an iterator
IteratorBase & operator=(const IteratorBase< false > & rhs)
assigns a const_iterator from an iterator; needs to be implemented because the copy c'tor is also explicitly implemented
IteratorBase & operator++()
prefix increment iterator, so it points to the next list element when trying to increment beyond the end of the list, iterator stays pointing at the end
IteratorBase & operator--()
prefix decrement iterator, so it points to the previous list element decrementing an iterator pointing already towards begin() has no effect (iterator stays at begin())
template <bool IsConstIteratorOther>
bool
operator==(const IteratorBase< IsConstIteratorOther > & rhs) const
comparing list iterators for equality the referenced list position is compared, not the content of the list element (T-typed) -> there is no content for fictional elements at BEGIN_END_LINK_INDEX only iterators of the same parent list can be compared; in case of misuse, terminate() is invoked
template <bool IsConstIteratorOther>
bool
operator!=(const IteratorBase< IsConstIteratorOther > & rhs) const
comparing list iterators for non-equality the referenced list position is compared, not the content of the list element (T-typed) -> there is no content for fictional elements at BEGIN_END_LINK_INDEX only iterators of the same parent list can be compared; in case of misuse, terminate() is invoked
reference operator*() const
dereferencing element content via iterator-position element
pointer operator->() const
dereferencing element content via iterator-position element

Friends🔗

Name
class IteratorBase< true >
class list< T, Capacity >

Detailed Description🔗

template <bool IsConstIterator =true>
class iox::cxx::list::IteratorBase;

nested iterator class for list element operations including element access comparison of iterator from different list is rejected by terminate()

Public Types Documentation🔗

using iterator_category🔗

using iox::cxx::list< T, Capacity >::IteratorBase< IsConstIterator >::iterator_category =  std::bidirectional_iterator_tag;

using value_type🔗

using iox::cxx::list< T, Capacity >::IteratorBase< IsConstIterator >::value_type =  typename std::conditional<IsConstIterator, const T, T>::type;

using difference_type🔗

using iox::cxx::list< T, Capacity >::IteratorBase< IsConstIterator >::difference_type =  void;

using pointer🔗

using iox::cxx::list< T, Capacity >::IteratorBase< IsConstIterator >::pointer =  typename std::conditional<IsConstIterator, const T*, T*>::type;

using reference🔗

using iox::cxx::list< T, Capacity >::IteratorBase< IsConstIterator >::reference =  typename std::conditional<IsConstIterator, const T&, T&>::type;

Public Functions Documentation🔗

function IteratorBase🔗

IteratorBase(
    const IteratorBase< false > & iter
)

construct a const_iterator from an iterator

Parameters:

  • iter is the iterator which will deliver list and index info for the const_iterator

function operator=🔗

IteratorBase & operator=(
    const IteratorBase< false > & rhs
)

assigns a const_iterator from an iterator; needs to be implemented because the copy c'tor is also explicitly implemented

Parameters:

  • rhs is the iterator which will deliver list and index info for the const_iterator

Return: reference to this iterator object

function operator++🔗

IteratorBase & operator++()

prefix increment iterator, so it points to the next list element when trying to increment beyond the end of the list, iterator stays pointing at the end

Return: reference to this iterator object

function operator--🔗

IteratorBase & operator--()

prefix decrement iterator, so it points to the previous list element decrementing an iterator pointing already towards begin() has no effect (iterator stays at begin())

Return: reference to this iterator object

function operator==🔗

template <bool IsConstIteratorOther>
bool operator==(
    const IteratorBase< IsConstIteratorOther > & rhs
) const

comparing list iterators for equality the referenced list position is compared, not the content of the list element (T-typed) -> there is no content for fictional elements at BEGIN_END_LINK_INDEX only iterators of the same parent list can be compared; in case of misuse, terminate() is invoked

Parameters:

  • rhs is the 2nd iterator to compare to

Return: list position for two iterators is the same (true) or different (false)

function operator!=🔗

template <bool IsConstIteratorOther>
bool operator!=(
    const IteratorBase< IsConstIteratorOther > & rhs
) const

comparing list iterators for non-equality the referenced list position is compared, not the content of the list element (T-typed) -> there is no content for fictional elements at BEGIN_END_LINK_INDEX only iterators of the same parent list can be compared; in case of misuse, terminate() is invoked

Parameters:

  • rhs is the 2nd iterator to compare to

Return: list position for two iterators is the same (true) or different (false)

function operator*🔗

reference operator*() const

dereferencing element content via iterator-position element

Return: reference to list element data

function operator->🔗

pointer operator->() const

dereferencing element content via iterator-position element

Return: pointer to const list data element

Friends🔗

friend IteratorBase< true >🔗

friend class IteratorBase< true >;

friend list< T, Capacity >🔗

friend class list< T, Capacity >;

Updated on 18 December 2023 at 13:11:42 CET