IteratorOverIterators< Iterator > Class Template Reference

#include <deal.II/base/iterator_range.h>

Detailed Description

template<typename Iterator>
class IteratorOverIterators< Iterator >

A class that implements the semantics of iterators over iterators as discussed in the design sections of the IteratorRange class.

Definition at line 199 of file iterator_range.h.

Public Types
using	BaseIterator = Iterator
using	iterator_category = std::forward_iterator_tag
using	value_type = Iterator
using	difference_type = typename Iterator::difference_type
using	pointer = Iterator *
using	reference = Iterator &

Public Member Functions
	IteratorOverIterators (const BaseIterator &iterator)
const BaseIterator &	operator* () const
const BaseIterator *	operator-> () const
IteratorOverIterators &	operator++ ()
IteratorOverIterators	operator++ (int)
bool	operator!= (const IteratorOverIterators &i_o_i) const
	operator const BaseIterator & () const

Private Attributes
BaseIterator	element_of_iterator_collection

Member Typedef Documentation

BaseIterator

template<typename Iterator>

using IteratorOverIterators< Iterator >::BaseIterator = Iterator

Typedef the elements of the collection to give them a name that is more distinct.

Definition at line 206 of file iterator_range.h.

iterator_category

template<typename Iterator>

using IteratorOverIterators< Iterator >::iterator_category = std::forward_iterator_tag

Mark the class as forward iterator and declare some alias which are standard for iterators and are used by algorithms to enquire about the specifics of the iterators they work on.

Definition at line 274 of file iterator_range.h.

value_type

template<typename Iterator>

using IteratorOverIterators< Iterator >::value_type = Iterator

Definition at line 275 of file iterator_range.h.

difference_type

template<typename Iterator>

using IteratorOverIterators< Iterator >::difference_type = typename Iterator::difference_type

Definition at line 276 of file iterator_range.h.

pointer

template<typename Iterator>

using IteratorOverIterators< Iterator >::pointer = Iterator *

Definition at line 277 of file iterator_range.h.

reference

template<typename Iterator>

using IteratorOverIterators< Iterator >::reference = Iterator &

Definition at line 278 of file iterator_range.h.

Constructor & Destructor Documentation

IteratorOverIterators()

template<typename Iterator>

IteratorOverIterators< Iterator >::IteratorOverIterators ( const BaseIterator & iterator )

inlineexplicit

Constructor. Initialize this iterator-over-iterator in such a way that it points to the given argument.

Parameters

iterator

An iterator to which this object is supposed to point.

Definition at line 307 of file iterator_range.h.

Member Function Documentation

operator*()

template<typename Iterator>

const IteratorOverIterators< Iterator >::BaseIterator & IteratorOverIterators< Iterator >::operator* ( ) const

inline

Dereferencing operator.

Returns

The iterator within the collection currently pointed to.

Definition at line 316 of file iterator_range.h.

operator->()

template<typename Iterator>

const IteratorOverIterators< Iterator >::BaseIterator * IteratorOverIterators< Iterator >::operator-> ( ) const

inline

Dereferencing operator.

Returns

The iterator within the collection currently pointed to.

Definition at line 325 of file iterator_range.h.

operator++() [1/2]

template<typename Iterator>

IteratorOverIterators< Iterator > & IteratorOverIterators< Iterator >::operator++ ( )

inline

Prefix increment operator. Move the current iterator to the next element of the collection and return the new value.

Definition at line 334 of file iterator_range.h.

operator++() [2/2]

template<typename Iterator>

IteratorOverIterators< Iterator > IteratorOverIterators< Iterator >::operator++ ( int )

inline

Postfix increment operator. Move the current iterator to the next element of the collection, but return the previous value of the iterator.

Definition at line 344 of file iterator_range.h.

operator!=()

template<typename Iterator>

bool IteratorOverIterators< Iterator >::operator!= ( const IteratorOverIterators< Iterator > & i_o_i ) const

inline

Comparison operator

Parameters

i_o_i

Another iterator over iterators.

Returns

Returns whether the current iterator points to a different object than the iterator represented by the argument.

Definition at line 355 of file iterator_range.h.

operator const BaseIterator &()

template<typename Iterator>

IteratorOverIterators< Iterator >::operator const BaseIterator & ( ) const

inline

Implicit conversion operator.

Warning

When you call this conversion operator (i.e., you convert this iterator-over-iterators to the iterator we are currently pointing to), you obtain a const reference to this underlying iterator. The only thing you can really do with this result is dereferencing itself: it presumably points to something useful, but since you don't know where the pointed to object lives, you shouldn't increment or decrement the iterator you get from this operator. As a consequence, the returned iterator is marked as const, as this should prevent you from doing anything other than dereference it.

Definition at line 364 of file iterator_range.h.

Member Data Documentation

element_of_iterator_collection

template<typename Iterator>

BaseIterator IteratorOverIterators< Iterator >::element_of_iterator_collection

private

The object this iterator currently points to.

Definition at line 284 of file iterator_range.h.

---

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

• include/deal.II/base/iterator_range.h