---

CdbRooNTupleR.rdl

Go to the documentation of this file.

#ifndef CDBROOTABLE_NTUPLE_R_RDL
#define CDBROOTABLE_NTUPLE_R_RDL

// File and Version Information:
//      $Id: CdbRooNTupleR.rdl,v 1.3 2005/01/11 09:02:38 gapon Exp $

#include "CdbRooTable/CdbRooNTupleBaseR.hh"

/// An abstract base class for persistent n-tuples
/**
  * This class adds a type safe interface of the n-tuple model by prividing
  * a set of virtual methods to access or modify the contents of a tuple.
  *
  * RESTRICTIONS:
  *
  *   (1) Rows are numbered beginning from 0.
  *
  *   (2) In all operations with rows, a row is defined through a STD vector
  *       of element type. The number of elements in the vector must be exactly
  *       the number of columns passed to the constructor.
  */
template< class E >
class CdbRooNTupleR : public CdbRooNTupleBaseR {

public:

    typedef E ElementType;

protected:

  /// Default constructor
  /**
    * Is useless, but it's required by the ROOT I/O streamers. Any attempts to use an object
    * constructed in this way would result in the corresponding errors reported.
    */
    CdbRooNTupleR( ) :
        CdbRooNTupleBaseR( )
    { }

  /// Normal constructor
  /**
    * @see CdbRooNTupleBaseR::CdbRooNTupleBaseR()
    */
    CdbRooNTupleR( UInt_t                          theNumberOfColumns,
                   const std::string&              theName,
                   const std::string&              theDescription,
                   const std::vector<std::string>& theColumnNames ) :
        CdbRooNTupleBaseR( theNumberOfColumns,
                           theName,
                           theDescription,
                           theColumnNames )
    {}

public:

  /// Get the number of rows in the tuple

    virtual UInt_t rows( ) const = 0;

  /// Get a row at a specified position
  /**
    * This method has to be implemented by a subclass.
    *
    * @return the completion status of the operation
    *
    * Returned status values:
    *
    *    CdbStatus::Success - successfull completion. The vector passed as a parameter
    *                         will be filled exactly the same number of elements as
    *                         the number of columns in the tuple.
    *
    *    CdbStatus::NotFound - a row with specified number is not found. The vector passed
    *                          as a parameter won't be modified.
    *
    *    CdbStatus::* - any other problem occured preventing the successfull completion
    *                   of the operation. The vector passed as a parameter won't be modified.
    *
    * Also see the RESTRICTIONS section at the defintion of the class for more
    * detailed information on values of parameters.
    *
    */
    virtual CdbStatus get_row( std::vector<E>& theRow,
                               const UInt_t    theNumber ) const = 0;

  /// Append a row by the end of an existing list
  /**
    * This method has to be implemented by a subclass.
    *
    * @return the completion status of the operation
    *
    * Returned status values:
    *
    *    CdbStatus::Success - successfull completion. The vector passed as a parameter
    *                         will be filled exactly the same number of elements as
    *                         the number of columns in the tuple.
    *
    *    CdbStatus::IllegalParameters - an incomplete row with wrong number of elements passed
    *                                   to the method. The number of elements must match
    *                                   the number of columns.
    *
    *    CdbStatus::* - any other problem occured preventing the successfull completion
    *                   of the operation. The vector passed as a parameter won't be modified.
    *
    * Also see the RESTRICTIONS section at the defintion of the class for more
    * detailed information on values of parameters.
    */
    virtual CdbStatus append_row( const std::vector<E>& theRow ) = 0;

    ClassDefT(CdbRooNTupleR<E>,1);
};

#endif /* CDBROOTABLE_NTUPLE_R_RDL */

---