Calibration/rdbModel/include/rdbModel/Db/ResultHandle.h

Go to the documentation of this file.

// $Header: /bes/bes/BossCvs/Calibration/rdbModel/rdbModel/Db/ResultHandle.h,v 1.2 2008/04/09
// 02:57:28 huangb Exp $
#ifndef RDBMODEL_RESULTHANDLE_H
#define RDBMODEL_RESULTHANDLE_H
#include <string>
#include <vector>
 
namespace rdbModel {
 
  /**
      Pure virtual class representing results of a query.  Each concrete
      implementation of Connection will have an associated concrete
      implementation of ResultHandle
  */
  class ResultHandle {
  public:
    ResultHandle(){};
    virtual ~ResultHandle(){};
 
    /// Return number of rows in results
    virtual unsigned int getNRows() const = 0;
 
    /**
         Get array of field values for ith row of result set
    */
    virtual bool getRow( std::vector<std::string>& fields, unsigned int i = 0,
                         bool clear = true ) = 0;
 
    virtual bool getRowCon( char* par, unsigned long* treesize, unsigned int* runFrm,
                            unsigned int* runTo, unsigned int i = 0, bool clear = true ) = 0;
    /**
         Get array of field values for ith row of result set.  If a field
         value is NULL, return a zero ptr for that element of the array
 
         --> It is the responsibility of the caller to delete the strings
             containing the field values.  See service cleanFieldPtrs.
    */
    virtual bool getRowPtrs( std::vector<std::string*>& fields, unsigned int i = 0,
                             bool clear = true ) = 0;
 
    static void cleanFieldPtrs( std::vector<std::string*>& fields );
    /*
    // Return specified row in results as a string
    virtual bool getRowString(std::string& row, unsigned int iRow=0) const = 0;
 
      Return vector of rows
         @param rows     to hold returned data
         @param iRow     starting row
         @param maxRow   maximum number of rows requested.  0 means "all"
         @param clear    if true, clear @a rows before storing new data
         @return         status
 
    virtual bool getRowStrings(std::vector<std::string>& rows,
                               unsigned int iRow=0, unsigned int maxRow=0,
                               bool clear=true) const = 0;
    */
  };
} // namespace rdbModel
#endif