template<typename Particle>
class KVTemplateEvent< Particle >::Iterator

Class used for iterating over particles in events.

Template Parameters

Particle Class used to describe particles belonging to the event: must derive from KVParticle

The Iterator class is an STL-compliant iterator which can be used to perform loops over particles in an event. Iterators of different types can be used for different kinds of iteration:

    KVEvent* event; // base pointer to an object of some concrete implementation of an event class
 
    Iterator it(event);  // default: Type::All, iterate over all particles
 
    Iterator it(event,{"some_selection", [](const Particle* n){ return // some condition applied to n}});
 
    Iterator it2(event, Type::OK);  // iterate over nuclei whose method KVNucleus::IsOK() returns kTRUE
 
    Iterator it3(event, Type::Group, "GroupName");  // iterate over nuclei belonging to previously-defined group "GroupName"

See also: KVTemplateEvent, Nuclei & Events

Examples: KVEvent_iterator_example.C.

Definition at line 117 of file KVTemplateEvent.h.

Public Types
typedef std::ptrdiff_t	difference_type

typedef std::forward_iterator_tag	iterator_category

typedef Particle *	pointer

typedef Particle &	reference

enum	Type { Null , All , OK , Group , Bad }

typedef Particle	value_type

Public Member Functions
	Iterator ()

	Iterator (const Iterator &i)

	Iterator (const KVEvent &e, const KVTemplateParticleCondition< Particle > &selection)

	Iterator (const KVEvent &e, Type t=Type::All, TString grp="")

	Iterator (const KVEvent *e, const KVTemplateParticleCondition< Particle > &selection)

	Iterator (const KVEvent *e, Type t=Type::All, TString grp="")

template<typename PointerType = Particle>
const PointerType *	get_const_pointer () const

template<typename ReferenceType = Particle>
const ReferenceType &	get_const_reference () const

template<typename PointerType = Particle>
PointerType *	get_pointer () const

template<typename ReferenceType = Particle>
ReferenceType &	get_reference () const

Bool_t	IsIterating () const

Bool_t	operator!= (const Iterator &it) const

Particle &	operator* () const

const Iterator &	operator++ ()

Iterator	operator++ (int)

Iterator &	operator= (const Iterator &rhs)

Bool_t	operator== (const Iterator &it) const

void	Reset (Type t=Type::Null, TString grp="")

void	SetIsIterating (Bool_t on=kTRUE)

Static Public Member Functions
static Iterator	End ()

Private Member Functions
Bool_t	AcceptableIteration ()

Particle *	current () const

Private Attributes
TIter	fIter

Bool_t	fIterating

KVTemplateParticleCondition< Particle >	fSelection

Type	fType

#include <KVTemplateEvent.h>

Member Typedef Documentation

◆ difference_type

template<typename Particle >

typedef std::ptrdiff_t KVTemplateEvent< Particle >::Iterator::difference_type

Definition at line 121 of file KVTemplateEvent.h.

◆ iterator_category

template<typename Particle >

typedef std::forward_iterator_tag KVTemplateEvent< Particle >::Iterator::iterator_category

Definition at line 119 of file KVTemplateEvent.h.

◆ pointer

template<typename Particle >

typedef Particle* KVTemplateEvent< Particle >::Iterator::pointer

Definition at line 122 of file KVTemplateEvent.h.

◆ reference

template<typename Particle >

typedef Particle& KVTemplateEvent< Particle >::Iterator::reference

Definition at line 123 of file KVTemplateEvent.h.

◆ value_type

template<typename Particle >

typedef Particle KVTemplateEvent< Particle >::Iterator::value_type

Definition at line 120 of file KVTemplateEvent.h.

Member Enumeration Documentation

◆ Type

template<typename Particle >

enum KVTemplateEvent::Iterator::Type

Enumerator
Null
All
OK
Group
Bad

Definition at line 125 of file KVTemplateEvent.h.

Constructor & Destructor Documentation

◆ Iterator() [1/6]

template<typename Particle >

KVTemplateEvent< Particle >::Iterator::Iterator ( )

inline

Definition at line 155 of file KVTemplateEvent.h.

◆ Iterator() [2/6]

template<typename Particle >

KVTemplateEvent< Particle >::Iterator::Iterator ( const Iterator & i )

inline

Definition at line 161 of file KVTemplateEvent.h.

◆ Iterator() [3/6]

template<typename Particle >

KVTemplateEvent< Particle >::Iterator::Iterator	(	const KVEvent *	e,
		const KVTemplateParticleCondition< Particle > &	selection
	)

inline

Construct an iterator object to read in sequence the particles in event *e using the given KVParticleCondition to select acceptable particles.

Definition at line 168 of file KVTemplateEvent.h.

◆ Iterator() [4/6]

template<typename Particle >

KVTemplateEvent< Particle >::Iterator::Iterator	(	const KVEvent &	e,
		const KVTemplateParticleCondition< Particle > &	selection
	)

inline

Construct an iterator object to read in sequence the particles in event *e using the given KVParticleCondition to select acceptable particles.

Definition at line 185 of file KVTemplateEvent.h.

◆ Iterator() [5/6]

template<typename Particle >

KVTemplateEvent< Particle >::Iterator::Iterator	(	const KVEvent *	e,
		Type	t = `Type::All`,
		TString	grp = `""`
	)

inline

Construct an iterator object to read in sequence the particles in event *e

Definition at line 202 of file KVTemplateEvent.h.

◆ Iterator() [6/6]

template<typename Particle >

KVTemplateEvent< Particle >::Iterator::Iterator	(	const KVEvent &	e,
		Type	t = `Type::All`,
		TString	grp = `""`
	)

inline

Construct an iterator object to read in sequence the particles in event *e

Definition at line 228 of file KVTemplateEvent.h.

Member Function Documentation

◆ AcceptableIteration()

template<typename Particle >

Bool_t KVTemplateEvent< Particle >::Iterator::AcceptableIteration ( )

inlineprivate

Returns kTRUE if the current particle in the iteration corresponds to the selection criteria (if none set, true for all)

Returns kFALSE for all particles if iterator is bad (particle class mismatch)

Definition at line 138 of file KVTemplateEvent.h.

◆ current()

template<typename Particle >

Particle* KVTemplateEvent< Particle >::Iterator::current ( ) const

inlineprivate

Returns pointer to current particle in iteration

Definition at line 149 of file KVTemplateEvent.h.

◆ End()

template<typename Particle >

static Iterator KVTemplateEvent< Particle >::Iterator::End ( void )

inlinestatic

Examples: KVEvent_iterator_example.C.

Definition at line 319 of file KVTemplateEvent.h.

◆ get_const_pointer()

template<typename Particle >

template<typename PointerType = Particle>

const PointerType* KVTemplateEvent< Particle >::Iterator::get_const_pointer ( ) const

inline

Definition at line 271 of file KVTemplateEvent.h.

◆ get_const_reference()

template<typename Particle >

template<typename ReferenceType = Particle>

const ReferenceType& KVTemplateEvent< Particle >::Iterator::get_const_reference ( ) const

inline

Definition at line 276 of file KVTemplateEvent.h.

◆ get_pointer()

template<typename Particle >

template<typename PointerType = Particle>

PointerType* KVTemplateEvent< Particle >::Iterator::get_pointer ( ) const

inline

Definition at line 261 of file KVTemplateEvent.h.

◆ get_reference()

template<typename Particle >

template<typename ReferenceType = Particle>

ReferenceType& KVTemplateEvent< Particle >::Iterator::get_reference ( ) const

inline

Definition at line 266 of file KVTemplateEvent.h.

◆ IsIterating()

template<typename Particle >

Bool_t KVTemplateEvent< Particle >::Iterator::IsIterating ( ) const

inline

returns kTRUE if iteration is in progress

Definition at line 348 of file KVTemplateEvent.h.

◆ operator!=()

template<typename Particle >

Bool_t KVTemplateEvent< Particle >::Iterator::operator!= ( const Iterator & it ) const

inline

returns kTRUE if the 2 iterators are not pointing to the same particle

Definition at line 280 of file KVTemplateEvent.h.

◆ operator*()

template<typename Particle >

Particle& KVTemplateEvent< Particle >::Iterator::operator* ( ) const

inline

Returns reference to current particle in iteration

Definition at line 254 of file KVTemplateEvent.h.

◆ operator++() [1/2]

template<typename Particle >

const Iterator& KVTemplateEvent< Particle >::Iterator::operator++ ( )

inline

Prefix ++ operator Advance iterator to next particle in event compatible with selection

Definition at line 290 of file KVTemplateEvent.h.

◆ operator++() [2/2]

template<typename Particle >

Iterator KVTemplateEvent< Particle >::Iterator::operator++ ( int )

inline

Postfix ++ operator Advance iterator to next particle in event compatible with selection

Definition at line 299 of file KVTemplateEvent.h.

◆ operator=()

template<typename Particle >

Iterator& KVTemplateEvent< Particle >::Iterator::operator= ( const Iterator & rhs )

inline

copy-assignment operator

Definition at line 307 of file KVTemplateEvent.h.

◆ operator==()

template<typename Particle >

Bool_t KVTemplateEvent< Particle >::Iterator::operator== ( const Iterator & it ) const

inline

returns kTRUE if the 2 iterators are pointing to the same particle

Definition at line 285 of file KVTemplateEvent.h.

◆ Reset()

template<typename Particle >

void KVTemplateEvent< Particle >::Iterator::Reset	(	Type	t = `Type::Null`,
		TString	grp = `""`
	)

inline

Reuse iterator, start iteration again

Reset() - use same selection criteria

Reset(Type t[, TString gr]) - change selection criteria

Definition at line 324 of file KVTemplateEvent.h.

◆ SetIsIterating()

template<typename Particle >

void KVTemplateEvent< Particle >::Iterator::SetIsIterating ( Bool_t on = kTRUE )

inline

set fIterating flag

Definition at line 353 of file KVTemplateEvent.h.

Member Data Documentation

◆ fIter

template<typename Particle >

TIter KVTemplateEvent< Particle >::Iterator::fIter

private

Definition at line 135 of file KVTemplateEvent.h.

◆ fIterating

template<typename Particle >

Bool_t KVTemplateEvent< Particle >::Iterator::fIterating

mutableprivate

Definition at line 137 of file KVTemplateEvent.h.

◆ fSelection

template<typename Particle >

KVTemplateParticleCondition<Particle> KVTemplateEvent< Particle >::Iterator::fSelection

private

Definition at line 134 of file KVTemplateEvent.h.

◆ fType

template<typename Particle >

Type KVTemplateEvent< Particle >::Iterator::fType

private

Definition at line 136 of file KVTemplateEvent.h.

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

kaliveda.doxygen/KVMultiDet/events/KVTemplateEvent.h

template<typename Particle> class KVTemplateEvent< Particle >::Iterator

Public Types

Public Member Functions

Static Public Member Functions

Private Member Functions

Private Attributes

Member Typedef Documentation

◆ difference_type

◆ iterator_category

◆ pointer

◆ reference

◆ value_type

Member Enumeration Documentation

◆ Type

Constructor & Destructor Documentation

◆ Iterator() [1/6]

◆ Iterator() [2/6]

◆ Iterator() [3/6]

◆ Iterator() [4/6]

◆ Iterator() [5/6]

◆ Iterator() [6/6]

Member Function Documentation

◆ AcceptableIteration()

◆ current()

◆ End()

◆ get_const_pointer()

◆ get_const_reference()

◆ get_pointer()

◆ get_reference()

◆ IsIterating()

◆ operator!=()

◆ operator*()

◆ operator++() [1/2]

◆ operator++() [2/2]

◆ operator=()

◆ operator==()

◆ Reset()

◆ SetIsIterating()

Member Data Documentation

◆ fIter

◆ fIterating

◆ fSelection

◆ fType

template<typename Particle>
class KVTemplateEvent< Particle >::Iterator