IOptions.h

Go to the documentation of this file.

// @(#)root/mathcore:$Id$
// Author: L. Moneta Fri Aug 15 2008
 
/**********************************************************************
 *                                                                    *
 * Copyright (c) 2008  LCG ROOT Math Team, CERN/PH-SFT                *
 *                                                                    *
 *                                                                    *
 **********************************************************************/
 
#ifndef ROOT_Math_IOptions
#define ROOT_Math_IOptions
 
 
#include "Math/Error.h"
 
#include <iostream>
 
namespace ROOT {
 
 
   namespace Math {
 
//_______________________________________________________________________________
/**
    Generic interface for defining configuration options of a numerical algorithm
 
    @ingroup NumAlgo
*/
class IOptions {
 
public:
 
   IOptions() /* : fExtraOptions(0) */  {}
 
   virtual ~IOptions() {}// { if (fExtraOptions) delete fExtraOptions; }
 
   // copy the options
   virtual IOptions * Clone() const = 0;
 
   /** generic  methods for  retrivieng options */
 
   /// set option value
   void SetValue(const char * name, double val) { SetRealValue(name,val);}
   void SetValue(const char * name, int val) { SetIntValue(name,val);}
   void SetValue(const char * name, const char * val) { SetNamedValue(name,val);}
 
 
   double  RValue(const char * name) const {
      double val = 0;
      bool ret = GetRealValue(name,val);
      if (!ret )  MATH_ERROR_MSGVAL("IOptions::RValue"," return 0 - real option not found",name);
      return val;
   }
 
   int   IValue(const char * name) const {
      int val = 0;
      bool ret = GetIntValue(name,val);
      if (!ret )   MATH_ERROR_MSGVAL("IOptions::IValue"," return 0 - integer option not found",name);
      return val;
   }
 
   std::string  NamedValue(const char * name) const {
      std::string val;
      bool ret = GetNamedValue(name,val);
      if (!ret )  MATH_ERROR_MSGVAL("IOptions::NamedValue"," return empty string - named option not found",name);
      return val;
   }
 
 
   // generic method to retrieve  a type
   template <typename T>
   bool GetValue(const char * name, T & t) const {
      bool ret = DoGetValue(name, t);
      //if (!ret )  MATH_ERROR_MSG("IOptions::GetValue","option is not existing - returns 0");
      return ret;
   }
 
 
   // methods to be re-implemented in the derived classes
 
 
   virtual bool GetRealValue(const char *, double &) const { return false; }
 
   virtual bool GetIntValue(const char *, int &) const { return false; }
 
   virtual bool GetNamedValue(const char *, std::string &) const { return false; }
 
   /// method wich need to be re-implemented by the derived classes
   virtual void SetRealValue(const char * , double )  {MATH_ERROR_MSG("IOptions::SetRealValue","Invalid setter method called"); }
 
   virtual void SetIntValue(const char * , int ) {MATH_ERROR_MSG("IOptions::SetIntValue","Invalid setter method called"); }
 
   virtual void SetNamedValue(const char * , const char * ) {MATH_ERROR_MSG("IOptions::SetNamedValue","Invalid setter method called"); }
 
 
   /// print options
   virtual void Print(std::ostream & = std::cout ) const {MATH_INFO_MSG("IOptions::Print","it is not implemented");}
 
 
private:
 
   bool DoGetValue(const char *name, double &val) const { return GetRealValue(name,val); }
 
   bool DoGetValue(const char *name, int &val) const { return GetIntValue(name,val); }
 
   bool DoGetValue(const char *name, std::string &val) const { return GetNamedValue(name,val); }
 
 
};
 
 
   } // end namespace Math
 
} // end namespace ROOT
 
#endif