art::RunID Class Reference

#include "RunID.h"

Classes
struct	FlushFlag

Public Member Functions
constexpr	RunID ()
	RunID (RunNumber_t i)
RunNumber_t	run () const
bool	isValid () const
bool	isFlush () const
RunID	next () const
RunID	previous () const
bool	operator== (RunID const &other) const
bool	operator!= (RunID const &other) const
bool	operator< (RunID const &other) const
bool	operator<= (RunID const &other) const
bool	operator> (RunID const &other) const
bool	operator>= (RunID const &other) const

Static Public Member Functions
static RunID	maxRun ()
static RunID	firstRun ()
static constexpr RunID	flushRun ()

Private Member Functions
constexpr	RunID (FlushFlag)
RunNumber_t	inRangeOrInvalid (RunNumber_t r)

Private Attributes
RunNumber_t	run_

Friends
std::ostream &	operator<< (std::ostream &os, RunID const &iID)

Detailed Description

Definition at line 21 of file RunID.h.

Constructor & Destructor Documentation

constexpr art::RunID::RunID ( )

inline

Definition at line 58 of file RunID.h.

Referenced by firstRun(), flushRun(), maxRun(), next(), and previous().

: run_(IDNumber<Level::Run>::invalid()) {}

art::RunID::RunID ( RunNumber_t  i )

inlineexplicit

Definition at line 60 of file RunID.h.

: run_(inRangeOrInvalid(i)) {}

constexpr art::RunID::RunID ( FlushFlag  )

inlineexplicitprivate

Definition at line 180 of file RunID.h.

  : run_{IDNumber<Level::Run>::flush_value()}
{}

Member Function Documentation

art::RunID art::RunID::firstRun ( )

inlinestatic

Definition at line 115 of file RunID.h.

References RunID().

Referenced by art::EmptyEvent::EmptyEvent(), art::SubRunID::firstSubRun(), art::RootInputFile::overrideRunNumber(), and art::RootInputFileSequence::RootInputFileSequence().

{
  return RunID(IDNumber<Level::Run>::first());
}

constexpr art::RunID art::RunID::flushRun ( )

inlinestatic

Definition at line 121 of file RunID.h.

References RunID().

{
  return RunID(FlushFlag());
}

art::RunNumber_t art::RunID::inRangeOrInvalid ( RunNumber_t  r )

inlineprivate

Definition at line 167 of file RunID.h.

References art::errors::InvalidNumber.

{
  if (r == IDNumber<Level::Run>::invalid() ||
      (r >= IDNumber<Level::Run>::first() &&
       r <= IDNumber<Level::Run>::max_natural())) {
    return r;
  } else {
    throw Exception(errors::InvalidNumber)
      << "Attempt to construct RunID with an invalid number.\n"
      << "Maybe you want RunID::flushRun()?\n";
  }
}

bool art::RunID::isFlush ( ) const

inline

Definition at line 75 of file RunID.h.

References run_.

Referenced by art::EventIDMatcher::match(), and art::operator<<().

{
  return (run_ == IDNumber<Level::Run>::flush_value());
}

bool art::RunID::isValid ( ) const

inline

Definition at line 69 of file RunID.h.

References run_.

Referenced by art::SubRunID::checkSane(), art::EmptyEvent::getNextItemType(), art::SubRunID::isValid(), art::EventIDMatcher::match(), next(), art::operator<<(), previous(), art::FileStatsCollector::recordRun(), art::PostCloseFileRenamer::subFilledNumericNoIndex_(), and art::Source< T >::throwIfInsane_().

{
  return (run_ != IDNumber<Level::Run>::invalid());
}

art::RunID art::RunID::maxRun ( )

inlinestatic

Definition at line 109 of file RunID.h.

References RunID().

Referenced by art::SubRunID::maxSubRun(), and art::RootInputFileSequence::RootInputFileSequence().

{
  return RunID(IDNumber<Level::Run>::max_natural());
}

art::RunID art::RunID::next ( ) const

inline

Definition at line 83 of file RunID.h.

References art::errors::InvalidNumber, isValid(), run_, and RunID().

Referenced by art::SubRunID::nextRun().

{
  if (!isValid()) {
    throw Exception(errors::InvalidNumber)
      << "cannot increment invalid run number.";
  } else if (run_ == IDNumber<Level::Run>::max_natural()) {
    throw Exception(errors::InvalidNumber)
      << "cannot increment maximum run number.";
  }
  return RunID(run_ + 1);
}

bool art::RunID::operator!= ( RunID const &  other ) const

inline

Definition at line 134 of file RunID.h.

References fhicl::other.

{
  return !(*this == other);
}

bool art::RunID::operator< ( RunID const &  other ) const

inline

Definition at line 142 of file RunID.h.

References run_.

{
  static SortInvalidFirst<RunNumber_t> op(IDNumber<Level::Run>::invalid());
  return op(run_, other.run_);
}

bool art::RunID::operator<= ( RunID const &  other ) const

inline

Definition at line 149 of file RunID.h.

References fhicl::other.

{
  return (*this < other) || (*this == other);
}

bool art::RunID::operator== ( RunID const &  other ) const

inline

Definition at line 128 of file RunID.h.

References run_.

{
  return other.run_ == run_;
}

bool art::RunID::operator> ( RunID const &  other ) const

inline

Definition at line 155 of file RunID.h.

{
  return (other < *this);
}

bool art::RunID::operator>= ( RunID const &  other ) const

inline

Definition at line 161 of file RunID.h.

References fhicl::other.

{
  return !(*this < other);
}

art::RunID art::RunID::previous ( ) const

inline

Definition at line 96 of file RunID.h.

References art::errors::InvalidNumber, isValid(), run_, and RunID().

Referenced by art::SubRunID::previousRun().

{
  if (!isValid()) {
    throw Exception(errors::InvalidNumber)
      << "cannot decrement minimum run number.";
  } else if (run_ == IDNumber<Level::Run>::max_natural()) {
    throw Exception(errors::InvalidNumber)
      << "cannot increment maximum run number.";
  }
  return RunID(run_ - 1);
}

art::RunNumber_t art::RunID::run ( ) const

inline

Definition at line 63 of file RunID.h.

References run_.

Referenced by art::EmptyEvent::EmptyEvent(), art::RangeSet::forRun(), spacecharge::SpaceChargeServiceStandard::preBeginRun(), detinfo::LArPropertiesServiceStandard::preBeginRun(), util::LArPropertiesServiceArgoNeuT::preBeginRun(), art::detail::rangeSetFromFileIndex(), art::RootInputFileSequence::RootInputFileSequence(), art::SubRunID::run(), and art::RunAuxiliary::run().

{
  return run_;
}

Friends And Related Function Documentation

std::ostream& operator<< ( std::ostream &  os, RunID const &  iID  )

friend

Member Data Documentation

RunNumber_t art::RunID::run_

private

Definition at line 55 of file RunID.h.

Referenced by isFlush(), isValid(), next(), operator<(), art::operator<<(), operator==(), previous(), and run().

---

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

• canvas/Persistency/Provenance/RunID.h