#include <deal.II/grid/tria_iterator.h>

Inheritance diagram for TriaIterator< Accessor >:

Public Types
typedef TriaRawIterator< Accessor >::iterator_category	iterator_category

Public Types inherited from TriaRawIterator< Accessor >
typedef Accessor	AccessorType

typedef std::bidirectional_iterator_tag	iterator_category

Public Member Functions
	TriaIterator ()

	TriaIterator (const TriaIterator< Accessor > &)

	TriaIterator (const TriaRawIterator< Accessor > &)

	TriaIterator (const Triangulation< Accessor::dimension, Accessor::space_dimension > parent, const int level, const int index, const typename Accessor::AccessorData local_data=nullptr)

template<typename OtherAccessor >
	TriaIterator (const OtherAccessor &a)

template<typename OtherAccessor >
	TriaIterator (const TriaIterator< OtherAccessor > &i)

	TriaIterator (const TriaAccessorBase< Accessor::structure_dimension, Accessor::dimension, Accessor::space_dimension > &tria_accessor, const typename Accessor::AccessorData *local_data)

template<typename OtherAccessor >
	TriaIterator (const TriaRawIterator< OtherAccessor > &i)

template<typename OtherAccessor >
	TriaIterator (const TriaActiveIterator< OtherAccessor > &i)

TriaIterator< Accessor > &	operator= (const TriaIterator< Accessor > &)

TriaIterator< Accessor > &	operator= (const TriaRawIterator< Accessor > &)

template<class OtherAccessor >
TriaIterator< Accessor > &	operator= (const TriaIterator< OtherAccessor > &)

template<class OtherAccessor >
TriaIterator< Accessor > &	operator= (const TriaRawIterator< OtherAccessor > &)

Advancement of iterators
TriaIterator< Accessor > &	operator++ ()

TriaIterator< Accessor >	operator++ (int)

TriaIterator< Accessor > &	operator-- ()

TriaIterator< Accessor >	operator-- (int)

Public Member Functions inherited from TriaRawIterator< Accessor >
	TriaRawIterator ()

	TriaRawIterator (const TriaRawIterator &)

	TriaRawIterator (const Accessor &a)

template<typename OtherAccessor >
	TriaRawIterator (const OtherAccessor &a)

	TriaRawIterator (const Triangulation< Accessor::dimension, Accessor::space_dimension > parent, const int level, const int index, const typename AccessorType::AccessorData local_data=nullptr)

template<typename OtherAccessor >
	TriaRawIterator (const TriaRawIterator< OtherAccessor > &i)

	TriaRawIterator (const TriaAccessorBase< Accessor::structure_dimension, Accessor::dimension, Accessor::space_dimension > &tria_accessor, const typename Accessor::AccessorData *local_data)

template<typename OtherAccessor >
	TriaRawIterator (const TriaIterator< OtherAccessor > &i)

template<typename OtherAccessor >
	TriaRawIterator (const TriaActiveIterator< OtherAccessor > &i)

TriaRawIterator &	operator= (const TriaRawIterator &)

bool	operator== (const TriaRawIterator &) const

bool	operator!= (const TriaRawIterator &) const

bool	operator< (const TriaRawIterator &) const

bool	operator> (const TriaRawIterator &) const

IteratorState::IteratorStates	state () const

template<class StreamType >
void	print (StreamType &out) const

std::size_t	memory_consumption () const

const Accessor &	operator* () const

Accessor &	operator* ()

const Accessor *	operator-> () const

Accessor *	operator-> ()

const Accessor &	access_any () const

TriaRawIterator &	operator++ ()

TriaRawIterator	operator++ (int)

TriaRawIterator &	operator-- ()

TriaRawIterator	operator-- (int)

Static Public Member Functions
static ::ExceptionBase &	ExcAssignmentOfUnusedObject ()

Static Public Member Functions inherited from TriaRawIterator< Accessor >
static ::ExceptionBase &	ExcDereferenceInvalidCell (Accessor arg1)

static ::ExceptionBase &	ExcDereferenceInvalidObject (Accessor arg1)

static ::ExceptionBase &	ExcAdvanceInvalidObject ()

static ::ExceptionBase &	ExcInvalidComparison ()

Additional Inherited Members
Protected Attributes inherited from TriaRawIterator< Accessor >
Accessor	accessor

Detailed Description

template<typename Accessor>
class TriaIterator< Accessor >

This specialization of TriaRawIterator provides access only to the used lines, quads, cells, etc.

Definition at line 30 of file dof_iterator_selector.h.

Member Typedef Documentation

◆ iterator_category

template<typename Accessor>

typedef TriaRawIterator<Accessor>::iterator_category TriaIterator< Accessor >::iterator_category

Declare some typedefs which are standard for iterators and are used by algorithms to enquire about the specifics of the iterators they work on.

Definition at line 691 of file tria_iterator.h.

Constructor & Destructor Documentation

◆ TriaIterator() [1/9]

template<typename Accessor>

TriaIterator< Accessor >::TriaIterator ( )

Empty constructor. Such an object is not usable!

◆ TriaIterator() [2/9]

template<typename Accessor>

TriaIterator< Accessor >::TriaIterator ( const TriaIterator< Accessor > & )

Copy constructor.

◆ TriaIterator() [3/9]

template<typename Accessor>

TriaIterator< Accessor >::TriaIterator ( const TriaRawIterator< Accessor > & )

Cross copy constructor from iterators pointing also to non-active objects.

If the object pointed to is not past-the-end and is not used, the debug version raises an error!

◆ TriaIterator() [4/9]

template<typename Accessor>

TriaIterator< Accessor >::TriaIterator	(	const Triangulation< Accessor::dimension, Accessor::space_dimension > *	parent,
		const int	level,
		const int	index,
		const typename Accessor::AccessorData *	local_data = `nullptr`
	)

Proper constructor, initialized with the triangulation, the level and index of the object pointed to. The last parameter is of a type declared by the accessor class.

If the object pointed to is not past-the-end and is not used, the debug version raises an error!

◆ TriaIterator() [5/9]

template<typename Accessor >

template<typename OtherAccessor >

TriaIterator< Accessor >::TriaIterator ( const OtherAccessor & a )

explicit

Construct from an accessor of type OtherAccessor that is convertible to the type Accessor.

Definition at line 1139 of file tria_iterator.h.

◆ TriaIterator() [6/9]

template<typename Accessor >

template<typename OtherAccessor >

TriaIterator< Accessor >::TriaIterator ( const TriaIterator< OtherAccessor > & i )

inline

This is a conversion operator (constructor) which takes another iterator type and copies the data; this conversion works, if there is a conversion path from the OtherAccessor class to the Accessor class of this object. One such path would be derived class to base class, which for example may be used to get a Triangulation::cell_iterator from a DoFHandler::cell_iterator, since the DoFAccessor class is derived from the TriaAccessorBase class.

Definition at line 1100 of file tria_iterator.h.

◆ TriaIterator() [7/9]

template<typename Accessor>

TriaIterator< Accessor >::TriaIterator	(	const TriaAccessorBase< Accessor::structure_dimension, Accessor::dimension, Accessor::space_dimension > &	tria_accessor,
		const typename Accessor::AccessorData *	local_data
	)

Another conversion operator, where we use the pointers to the Triangulation from a TriaAccessorBase object, while the additional data is used according to the actual type of Accessor.

◆ TriaIterator() [8/9]

template<typename Accessor >

template<typename OtherAccessor >

TriaIterator< Accessor >::TriaIterator ( const TriaRawIterator< OtherAccessor > & i )

inline

Similar conversion operator to the above one, but does a check whether the iterator points to a used element, which is necessary for raw iterators.

Definition at line 1120 of file tria_iterator.h.

◆ TriaIterator() [9/9]

template<typename Accessor >

template<typename OtherAccessor >

TriaIterator< Accessor >::TriaIterator ( const TriaActiveIterator< OtherAccessor > & i )

inline

Similar conversion operator to the above one, but for conversion from active iterators.

Definition at line 1110 of file tria_iterator.h.

Member Function Documentation

◆ operator=() [1/4]

template<typename Accessor>

TriaIterator<Accessor>& TriaIterator< Accessor >::operator= ( const TriaIterator< Accessor > & )

Assignment operator.

◆ operator=() [2/4]

template<typename Accessor>

TriaIterator<Accessor>& TriaIterator< Accessor >::operator= ( const TriaRawIterator< Accessor > & )

Cross assignment operator. This assignment is only valid if the given iterator points to a used element.

◆ operator=() [3/4]

template<typename Accessor>

template<class OtherAccessor >

TriaIterator<Accessor>& TriaIterator< Accessor >::operator= ( const TriaIterator< OtherAccessor > & )

Assignment operator. Requires, that Accessor can be copied from OtherAccessor.

◆ operator=() [4/4]

template<typename Accessor>

template<class OtherAccessor >

TriaIterator<Accessor>& TriaIterator< Accessor >::operator= ( const TriaRawIterator< OtherAccessor > & )

Cross assignment operator. This assignment is only valid if the given iterator points to a used element. Requires, that Accessor can be copied from OtherAccessor.

◆ operator++() [1/2]

template<typename Accessor>

TriaIterator<Accessor>& TriaIterator< Accessor >::operator++ ( )

Prefix ++ operator: ++i. This operator advances the iterator to the next used element and returns a reference to *this.

◆ operator++() [2/2]

template<typename Accessor>

TriaIterator<Accessor> TriaIterator< Accessor >::operator++ ( int )

Postfix ++ operator: i++. This operator advances the iterator to the next used element, but returns an iterator to the element previously pointed to. Since this involves a temporary and a copy operation and since an active_iterator is quite a large object for a pointer, use the prefix operator ++i whenever possible, especially in the head of for loops (for (; i!=end; ++i)) since there you normally never need the returned value.

◆ operator--() [1/2]

template<typename Accessor>

TriaIterator<Accessor>& TriaIterator< Accessor >::operator-- ( )

Prefix – operator: –i. This operator advances the iterator to the previous used element and returns a reference to *this.

◆ operator--() [2/2]

template<typename Accessor>

TriaIterator<Accessor> TriaIterator< Accessor >::operator-- ( int )

Postfix – operator: i–.

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

deal.II/dofs/dof_iterator_selector.h
deal.II/grid/tria_iterator.h

Public Types

Public Member Functions

Static Public Member Functions

Additional Inherited Members

Detailed Description

template<typename Accessor> class TriaIterator< Accessor >

Member Typedef Documentation

◆ iterator_category

Constructor & Destructor Documentation

◆ TriaIterator() [1/9]

◆ TriaIterator() [2/9]

◆ TriaIterator() [3/9]

◆ TriaIterator() [4/9]

◆ TriaIterator() [5/9]

◆ TriaIterator() [6/9]

◆ TriaIterator() [7/9]

◆ TriaIterator() [8/9]

◆ TriaIterator() [9/9]

Member Function Documentation

◆ operator=() [1/4]

◆ operator=() [2/4]

◆ operator=() [3/4]

◆ operator=() [4/4]

◆ operator++() [1/2]

◆ operator++() [2/2]

◆ operator--() [1/2]

◆ operator--() [2/2]

template<typename Accessor>
class TriaIterator< Accessor >