geo::details::geometry_element_iterator< GEOIDITER > Class Template Reference

Forward iterator browsing all geometry elements in the detector. More...

#include <GeometryCore.h>

Inheritance diagram for geo::details::geometry_element_iterator< GEOIDITER >:

Public Types
using	id_iterator_t = GEOIDITER
using	iterator = geometry_element_iterator< id_iterator_t >
	this type More...
using	Element_t = typename std::remove_pointer< ElementPtr_t >::type
	Geometry class pointed by the iterator. More...
Types mirrored from the ID iterator
using	LocalID_t = typename id_iterator_t::LocalID_t
using	GeoID_t = typename id_iterator_t::GeoID_t
using	UndefinedPos_t = typename id_iterator_t::UndefinedPos_t
using	BeginPos_t = typename id_iterator_t::BeginPos_t
using	EndPos_t = typename id_iterator_t::EndPos_t
using	ElementPtr_t = typename id_iterator_t::ElementPtr_t
Iterator traits
using	difference_type = std::ptrdiff_t
using	value_type = Element_t
using	reference = value_type const &
using	pointer = value_type const *
using	iterator_category = std::forward_iterator_tag

Public Member Functions
	geometry_element_iterator ()=default
	Default constructor; effect not defined: assign to it before using! More...
	geometry_element_iterator (geo::GeometryCore const *geom)
	Constructor: points to begin. More...
	geometry_element_iterator (id_iterator_t const &iter)
	Constructor: points to the same element as the specified ID iterator. More...
	geometry_element_iterator (id_iterator_t &&iter)
	Constructor: points to the same element as the specified ID iterator. More...
	geometry_element_iterator (geo::GeometryCore const *geom, GeoID_t const &start_from)
	Constructor: points to the specified geometry element. More...
	geometry_element_iterator (geo::GeometryCore const *geom, BeginPos_t const pos)
	Constructor: points to beginning. More...
	geometry_element_iterator (geo::GeometryCore const *geom, EndPos_t const pos)
	Constructor: points to end. More...
bool	operator== (iterator const &as) const
	Returns true if the two iterators point to the same object. More...
bool	operator!= (iterator const &as) const
	Returns true if the two iterators point to different objects. More...
reference	operator* () const
	Returns the geometry element the iterator points to. More...
pointer	operator-> () const
	Returns a pointer to the element the iterator points to (or nullptr) More...
iterator &	operator++ ()
	Prefix increment: returns this iterator pointing to the next element. More...
iterator	operator++ (int)
	Postfix increment: returns the current iterator, then increments it. More...
	operator bool () const
	Returns whether the iterator is pointing to a valid geometry element. More...
ElementPtr_t	get () const
	Returns a pointer to the geometry element, or nullptr if invalid. More...
LocalID_t const &	ID () const
	Returns the ID of the pointed geometry element. More...

Protected Member Functions
id_iterator_t const &	id_iterator () const
	Access to the base ID iterator. More...
id_iterator_t &	id_iterator ()

Private Attributes
id_iterator_t	id_iter
	iterator performing the job More...

Friends
bool	geo::details::operator== (iterator const &iter, id_iterator_t const &id_iter)
bool	geo::details::operator== (id_iterator_t const &id_iter, iterator const &iter)
bool	geo::details::operator!= (iterator const &iter, id_iterator_t const &id_iter)
bool	geo::details::operator!= (id_iterator_t const &id_iter, iterator const &iter)

Additional Inherited Members
Static Public Attributes inherited from geo::details::geometry_iterator_types
static constexpr BeginPos_t	begin_pos = {}
static constexpr EndPos_t	end_pos = {}
static constexpr UndefinedPos_t	undefined_pos = {}

Detailed Description

template<typename GEOIDITER>
class geo::details::geometry_element_iterator< GEOIDITER >

Forward iterator browsing all geometry elements in the detector.

Template Parameters

GEOITER

type of geometry ID iterator

This iterator works as the corresponding ID iterator in the template argument. The difference is the dereferenciation operator: this one obtains the geometry element directly, or throws on failure. The boolean conversion operator checks that it can obtain a pointer to the geometry element.

In particular, get() and ID() methods still return the pointer to the geometry element and its ID, respectively.

It can also be initialized and compare with the corresponding ID iterator.

Definition at line 719 of file GeometryCore.h.

Member Typedef Documentation

template<typename GEOIDITER>

using geo::details::geometry_element_iterator< GEOIDITER >::BeginPos_t = typename id_iterator_t::BeginPos_t

Definition at line 785 of file GeometryCore.h.

template<typename GEOIDITER>

using geo::details::geometry_element_iterator< GEOIDITER >::difference_type = std::ptrdiff_t

Definition at line 803 of file GeometryCore.h.

template<typename GEOIDITER>

using geo::details::geometry_element_iterator< GEOIDITER >::Element_t = typename std::remove_pointer<ElementPtr_t>::type

Geometry class pointed by the iterator.

Definition at line 798 of file GeometryCore.h.

template<typename GEOIDITER>

using geo::details::geometry_element_iterator< GEOIDITER >::ElementPtr_t = typename id_iterator_t::ElementPtr_t

Definition at line 787 of file GeometryCore.h.

template<typename GEOIDITER>

using geo::details::geometry_element_iterator< GEOIDITER >::EndPos_t = typename id_iterator_t::EndPos_t

Definition at line 786 of file GeometryCore.h.

template<typename GEOIDITER>

using geo::details::geometry_element_iterator< GEOIDITER >::GeoID_t = typename id_iterator_t::GeoID_t

Definition at line 783 of file GeometryCore.h.

template<typename GEOIDITER>

using geo::details::geometry_element_iterator< GEOIDITER >::id_iterator_t = GEOIDITER

Definition at line 770 of file GeometryCore.h.

template<typename GEOIDITER>

using geo::details::geometry_element_iterator< GEOIDITER >::iterator = geometry_element_iterator<id_iterator_t>

this type

Definition at line 778 of file GeometryCore.h.

template<typename GEOIDITER>

using geo::details::geometry_element_iterator< GEOIDITER >::iterator_category = std::forward_iterator_tag

Definition at line 807 of file GeometryCore.h.

template<typename GEOIDITER>

using geo::details::geometry_element_iterator< GEOIDITER >::LocalID_t = typename id_iterator_t::LocalID_t

Definition at line 782 of file GeometryCore.h.

template<typename GEOIDITER>

using geo::details::geometry_element_iterator< GEOIDITER >::pointer = value_type const*

Definition at line 806 of file GeometryCore.h.

template<typename GEOIDITER>

using geo::details::geometry_element_iterator< GEOIDITER >::reference = value_type const&

Definition at line 805 of file GeometryCore.h.

template<typename GEOIDITER>

using geo::details::geometry_element_iterator< GEOIDITER >::UndefinedPos_t = typename id_iterator_t::UndefinedPos_t

Definition at line 784 of file GeometryCore.h.

template<typename GEOIDITER>

using geo::details::geometry_element_iterator< GEOIDITER >::value_type = Element_t

Definition at line 804 of file GeometryCore.h.

Constructor & Destructor Documentation

template<typename GEOIDITER>

geo::details::geometry_element_iterator< GEOIDITER >::geometry_element_iterator ( )

default

Default constructor; effect not defined: assign to it before using!

template<typename GEOIDITER>

geo::details::geometry_element_iterator< GEOIDITER >::geometry_element_iterator ( geo::GeometryCore const *  geom )

inline

Constructor: points to begin.

Definition at line 815 of file GeometryCore.h.

                                                            :
        id_iter(geom) {}

template<typename GEOIDITER>

geo::details::geometry_element_iterator< GEOIDITER >::geometry_element_iterator ( id_iterator_t const &  iter )

inline

Constructor: points to the same element as the specified ID iterator.

Definition at line 819 of file GeometryCore.h.

: id_iter(iter) {}

template<typename GEOIDITER>

geo::details::geometry_element_iterator< GEOIDITER >::geometry_element_iterator ( id_iterator_t &&  iter )

inline

Constructor: points to the same element as the specified ID iterator.

Definition at line 822 of file GeometryCore.h.

: id_iter(iter) {}

template<typename GEOIDITER>

geo::details::geometry_element_iterator< GEOIDITER >::geometry_element_iterator ( geo::GeometryCore const *  geom, GeoID_t const &  start_from  )

inline

Constructor: points to the specified geometry element.

Definition at line 826 of file GeometryCore.h.

                                                                :
        id_iter(geom, start_from)
        {}

template<typename GEOIDITER>

geo::details::geometry_element_iterator< GEOIDITER >::geometry_element_iterator ( geo::GeometryCore const *  geom, BeginPos_t const  pos  )

inline

Constructor: points to beginning.

Definition at line 832 of file GeometryCore.h.

                                                           :
        id_iter(geom, pos)
        {}

template<typename GEOIDITER>

geo::details::geometry_element_iterator< GEOIDITER >::geometry_element_iterator ( geo::GeometryCore const *  geom, EndPos_t const  pos  )

inline

Constructor: points to end.

Definition at line 838 of file GeometryCore.h.

                                                         :
        id_iter(geom, pos)
        {}

Member Function Documentation

template<typename GEOIDITER>

ElementPtr_t geo::details::geometry_element_iterator< GEOIDITER >::get ( ) const

inline

Returns a pointer to the geometry element, or nullptr if invalid.

Definition at line 880 of file GeometryCore.h.

{ return id_iterator().get(); }

template<typename GEOIDITER>

LocalID_t const& geo::details::geometry_element_iterator< GEOIDITER >::ID ( ) const

inline

Returns the ID of the pointed geometry element.

Definition at line 883 of file GeometryCore.h.

{ return *(id_iterator()); }

template<typename GEOIDITER>

id_iterator_t const& geo::details::geometry_element_iterator< GEOIDITER >::id_iterator ( ) const

inlineprotected

Access to the base ID iterator.

Definition at line 897 of file GeometryCore.h.

{ return id_iter; }

template<typename GEOIDITER>

id_iterator_t& geo::details::geometry_element_iterator< GEOIDITER >::id_iterator ( )

inlineprotected

Definition at line 898 of file GeometryCore.h.

{ return id_iter; }

template<typename GEOIDITER>

geo::details::geometry_element_iterator< GEOIDITER >::operator bool ( ) const

inline

Returns whether the iterator is pointing to a valid geometry element.

Definition at line 876 of file GeometryCore.h.

        { return bool(id_iterator()) && (id_iterator().get() != nullptr); }

template<typename GEOIDITER>

bool geo::details::geometry_element_iterator< GEOIDITER >::operator!= ( iterator const &  as ) const

inline

Returns true if the two iterators point to different objects.

Definition at line 847 of file GeometryCore.h.

        { return id_iterator() != as.id_iterator(); }

template<typename GEOIDITER>

reference geo::details::geometry_element_iterator< GEOIDITER >::operator* ( ) const

inline

Returns the geometry element the iterator points to.

Returns

a constant reference to the element the iterator points to

Exceptions

cet::exception

(category "geometry_iterator") if no valid geometry element is currently pointed by the iterator

Definition at line 856 of file GeometryCore.h.

        {
          ElementPtr_t ptr = get();
          if (ptr) return *ptr;
          throw cet::exception("geometry_iterator")
            << "iterator attempted to obtain geometry element "
            << std::string(ID());
        } // operator*()

template<typename GEOIDITER>

iterator& geo::details::geometry_element_iterator< GEOIDITER >::operator++ ( )

inline

Prefix increment: returns this iterator pointing to the next element.

Definition at line 869 of file GeometryCore.h.

{ ++id_iterator(); return *this; }

template<typename GEOIDITER>

iterator geo::details::geometry_element_iterator< GEOIDITER >::operator++ ( int  )

inline

Postfix increment: returns the current iterator, then increments it.

Definition at line 872 of file GeometryCore.h.

        { iterator old(*this); ++id_iterator(); return old; }

template<typename GEOIDITER>

pointer geo::details::geometry_element_iterator< GEOIDITER >::operator-> ( ) const

inline

Returns a pointer to the element the iterator points to (or nullptr)

Definition at line 866 of file GeometryCore.h.

{ return get(); }

template<typename GEOIDITER>

bool geo::details::geometry_element_iterator< GEOIDITER >::operator== ( iterator const &  as ) const

inline

Returns true if the two iterators point to the same object.

Definition at line 843 of file GeometryCore.h.

        { return id_iterator() == as.id_iterator(); }

Friends And Related Function Documentation

template<typename GEOIDITER>

bool geo::details::operator!= ( iterator const &  iter, id_iterator_t const &  id_iter  )

friend

template<typename GEOIDITER>

bool geo::details::operator!= ( id_iterator_t const &  id_iter, iterator const &  iter  )

friend

template<typename GEOIDITER>

bool geo::details::operator== ( iterator const &  iter, id_iterator_t const &  id_iter  )

friend

template<typename GEOIDITER>

bool geo::details::operator== ( id_iterator_t const &  id_iter, iterator const &  iter  )

friend

Member Data Documentation

template<typename GEOIDITER>

id_iterator_t geo::details::geometry_element_iterator< GEOIDITER >::id_iter

private

iterator performing the job

Definition at line 902 of file GeometryCore.h.

---

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

• larcorealg/larcorealg/Geometry/GeometryCore.h