| 1 | /*
 | 
|---|
| 2 |  * Value.hpp
 | 
|---|
| 3 |  *
 | 
|---|
| 4 |  *  Created on: Apr 13, 2012
 | 
|---|
| 5 |  *      Author: ankele
 | 
|---|
| 6 |  */
 | 
|---|
| 7 | 
 | 
|---|
| 8 | #ifndef VALUE_HPP_
 | 
|---|
| 9 | #define VALUE_HPP_
 | 
|---|
| 10 | 
 | 
|---|
| 11 | 
 | 
|---|
| 12 | // include config.h
 | 
|---|
| 13 | #ifdef HAVE_CONFIG_H
 | 
|---|
| 14 | #include <config.h>
 | 
|---|
| 15 | #endif
 | 
|---|
| 16 | 
 | 
|---|
| 17 | #include <string>
 | 
|---|
| 18 | #include <vector>
 | 
|---|
| 19 | 
 | 
|---|
| 20 | #include "ValueInterface.hpp"
 | 
|---|
| 21 | #include "Validators/Validator.hpp"
 | 
|---|
| 22 | 
 | 
|---|
| 23 | #include "StreamOperators.hpp"
 | 
|---|
| 24 | 
 | 
|---|
| 25 | #include "CodePatterns/Range.hpp"
 | 
|---|
| 26 | #include "CodePatterns/toString.hpp"
 | 
|---|
| 27 | 
 | 
|---|
| 28 | class ValueTest;
 | 
|---|
| 29 | template <class T>
 | 
|---|
| 30 | class Parameter;
 | 
|---|
| 31 | class ParameterException;
 | 
|---|
| 32 | class ParameterValidatorException;
 | 
|---|
| 33 | class ParameterValueException;
 | 
|---|
| 34 | 
 | 
|---|
| 35 | /** Converter for a string to a std::vector of any class
 | 
|---|
| 36 |  * We use default conversion via stringstream as suggested by [Stroustrup].
 | 
|---|
| 37 |  * \param _&_object reference to object to convert.
 | 
|---|
| 38 |  * \return converted \a _object of templated type
 | 
|---|
| 39 |  */
 | 
|---|
| 40 | template <class T>
 | 
|---|
| 41 | struct ConvertTo< std::vector<T> > {
 | 
|---|
| 42 |   std::vector<T> operator()(std::string _object) {
 | 
|---|
| 43 |     std::vector<T> returnobjects;
 | 
|---|
| 44 |     std::stringstream s;
 | 
|---|
| 45 |     T object;
 | 
|---|
| 46 |     s << _object;
 | 
|---|
| 47 |     while (s.good()) {
 | 
|---|
| 48 |       s >> object;
 | 
|---|
| 49 |       returnobjects.push_back(object);
 | 
|---|
| 50 |     }
 | 
|---|
| 51 |     return returnobjects;
 | 
|---|
| 52 |   }
 | 
|---|
| 53 | };
 | 
|---|
| 54 | 
 | 
|---|
| 55 | /** This class represents a general value.
 | 
|---|
| 56 |  *
 | 
|---|
| 57 |  */
 | 
|---|
| 58 | template <class T>
 | 
|---|
| 59 | class Value : virtual public ValueInterface<T>
 | 
|---|
| 60 | {
 | 
|---|
| 61 |   //!> unit test needs to have access to internal values
 | 
|---|
| 62 |   friend class ValueTest;
 | 
|---|
| 63 |   friend class ContinuousValueTest;
 | 
|---|
| 64 |   friend class Parameter<T>;
 | 
|---|
| 65 | public:
 | 
|---|
| 66 |   Value();
 | 
|---|
| 67 |   Value(const Validator<T> &_validator);
 | 
|---|
| 68 |   Value(const std::vector<T> &_ValidValues);
 | 
|---|
| 69 |   Value(const range<T> &_ValidRange);
 | 
|---|
| 70 |   virtual ~Value();
 | 
|---|
| 71 | 
 | 
|---|
| 72 |   // functions for ValueInterface
 | 
|---|
| 73 |   bool isValid(const T &_value) const throw(ParameterValidatorException);
 | 
|---|
| 74 |   const T & get() const throw(ParameterValueException);
 | 
|---|
| 75 |   void set(const T & _value) throw(ParameterException);
 | 
|---|
| 76 |   bool isSet() const;
 | 
|---|
| 77 | 
 | 
|---|
| 78 |   // string functions for ValueInterface
 | 
|---|
| 79 |   bool isValidAsString(const std::string _value) const throw(ParameterValidatorException);
 | 
|---|
| 80 |   const std::string getAsString() const throw(ParameterValueException);
 | 
|---|
| 81 |   void setAsString(const std::string _value) throw(ParameterException);
 | 
|---|
| 82 | 
 | 
|---|
| 83 |   // comfortable setter
 | 
|---|
| 84 |   Value<T> &operator=(const T &_value)
 | 
|---|
| 85 |   { set(_value);  return *this;  }
 | 
|---|
| 86 | 
 | 
|---|
| 87 |   // comparator
 | 
|---|
| 88 |   bool operator==(const Value<T> &_instance) const throw(ParameterValidatorException);
 | 
|---|
| 89 |   bool operator!=(const Value<T> &_instance) const throw(ParameterValidatorException)
 | 
|---|
| 90 |       { return !((*this)==(_instance)); }
 | 
|---|
| 91 | 
 | 
|---|
| 92 |   const Validator<T> & getValidator() const;
 | 
|---|
| 93 |   Validator<T> & getValidator();
 | 
|---|
| 94 | 
 | 
|---|
| 95 |   // comfortable validator functions
 | 
|---|
| 96 |   const range<T> & getValidRange() const throw(ParameterValidatorException);
 | 
|---|
| 97 |   void setValidRange(const range<T> &_range) throw(ParameterValueException);
 | 
|---|
| 98 |   void appendValidValue(const T &_value) throw(ParameterValidatorException);
 | 
|---|
| 99 |   const std::vector<T> &getValidValues() const throw(ParameterValidatorException);
 | 
|---|
| 100 | 
 | 
|---|
| 101 | private:
 | 
|---|
| 102 |   //!> Internal converter from string to internal type
 | 
|---|
| 103 |   static ConvertTo<T> Converter;
 | 
|---|
| 104 | 
 | 
|---|
| 105 |   //!> whether a value has been set or not
 | 
|---|
| 106 |   bool ValueSet;
 | 
|---|
| 107 |   //!> contained value
 | 
|---|
| 108 |   T value;
 | 
|---|
| 109 | 
 | 
|---|
| 110 |   //!> the validator
 | 
|---|
| 111 |   Validator<T> *validator;
 | 
|---|
| 112 | };
 | 
|---|
| 113 | 
 | 
|---|
| 114 | #include "Value_impl.hpp"
 | 
|---|
| 115 | 
 | 
|---|
| 116 | 
 | 
|---|
| 117 | #endif /* VALUE_HPP_ */
 | 
|---|