BXVector.h

Go to the documentation of this file.

#ifndef BXVector_h
#define BXVector_h

// this class is an extension of std::vector
// designed to store objects corresponding to several time-samples (BX)
// the time sample is addressed by an integer index, eg. -1 to 1

#include <vector>

template < class T >
class BXVector  {

 public:

  typedef typename std::vector< T >::iterator       iterator;
  typedef typename std::vector< T >::const_iterator const_iterator;

 public:

  // default ctor
  BXVector( unsigned size=0,      // number of objects per BX
        int bxFirst=0,   // first BX stored
        int bxLast=0 );  // last BX stored

  // copy ctor
  // BXVector ( const BXVector& vector );

  // dtor
  //~BXVector();

  // assignment operator (pass by value for exception safety)
  //BXVector operator=(BXVector vector );

  // the methods given below are a minimal set
  // other methods from the std::vector interface can be replicated as desired

  // set BX range
  void setBXRange( int bxFirst, int bxLast );

  // set size for a given BX
  void resize( int bx, unsigned size );

  // set size for all BXs
  void resizeAll( unsigned size );
  
  // add one BX to end of BXVector
  void addBX();

  // delete given bunch crossing
  void deleteBX(int bx);

  // get the first BX stored
  int getFirstBX() const;

  // get the last BX stored
  int getLastBX() const;

  // iterator access by BX
  const_iterator begin( int bx ) const;

  // iterator access by BX
  const_iterator end( int bx ) const;

  // get N objects for a given BX
  unsigned size( int bx ) const;

  // add element with given BX index
  void push_back( int bx, T object );
 
  // erase element with given location 
  void erase( int bx, unsigned i);
  
  // insert element with given location
  void insert( int bx, unsigned i, T object );

  // clear entire BXVector
  void clear();

  // clear bx
  void clearBX(int bx);

  // access element
  const T& at( int bx, unsigned i ) const;

  // set element
  void set( int bx, unsigned i , const T & object);

  // check if data has empty location
  bool isEmpty(int bx) const;

 private:

  // this method converts integer BX index into an unsigned index
  // used by the internal data representation
  unsigned indexFromBX(int bx) const;
  unsigned numBX() const {return static_cast<const unsigned>(bxLast_) - bxFirst_; }

 private:

  //  need to keep a record of the BX ranges
  // in order to convert from int BX to the unsigned index
  int bxFirst_;
  int bxLast_;

  // a flat vector is preferable from the persistency point of view
  // but handling the start/end points for each BX is more complex
  // a second vector is needed to store pointers into the first one
  std::vector< T > data_;
  std::vector<unsigned> itrs_;
};

#include "BXVector.impl"

#endif