1 /* *********************************************************************

2 * This Original Work is copyright of 51 Degrees Mobile Experts Limited.

4 * Forbury Square, Reading, Berkshire, United Kingdom RG1 3EU.

5 *

6 * This Original Work is licensed under the European Union Public Licence

7 * (EUPL) v.1.2 and is subject to its terms as set out below.

8 *

9 * If a copy of the EUPL was not distributed with this file, You can obtain

10 * one at https://opensource.org/licenses/EUPL-1.2.

11 *

12 * The 'Compatible Licences' set out in the Appendix to the EUPL (as may be

13 * amended by the European Commission) shall be deemed incompatible for

14 * the purposes of the Work and the provisions of the compatibility

15 * clause in Article 5 of the EUPL shall not apply.

16 *

17 * If using the Work as, or as part of, a network application, by

18 * including the attribution notice(s) required under Article 5 of the EUPL

19 * in the end user terms of the application under an appropriate heading,

20 * such notice(s) shall fulfill the requirements of that article.

21 * ********************************************************************* */

22

23 #ifndef FIFTYONE_DEGREES_VALUE_HPP

24 #define FIFTYONE_DEGREES_VALUE_HPP

25

26 #include "Exceptions.hpp"

27 #include "results.h"

28

29 using namespace std;

30

31 namespace FiftyoneDegrees {

32 namespace Common {

75 template <class T> class Value {

76 public:

85 Value() {

86 this->value = T();

87 this->hasValueInternal = false;

88 }

89

101 bool hasValue() {

102 return hasValueInternal;

103 }

104

111 fiftyoneDegreesResultsNoValueReason getNoValueReason() {

112 return noValueReason;

113 }

114

120 const char* getNoValueMessage() {

121 return noValueMessage;

122 }

123

130 T getValue() {

131 if (hasValueInternal) {

132 return value;

133 }

134 else {

135 switch (noValueReason) {

136 case FIFTYONE_DEGREES_RESULTS_NO_VALUE_REASON_INVALID_PROPERTY:

137 if (noValueMessage != nullptr) {

138 throw InvalidPropertyException(noValueMessage);

139 }

140 else {

141 throw InvalidPropertyException();

142 }

143 case FIFTYONE_DEGREES_RESULTS_NO_VALUE_REASON_TOO_MANY_VALUES:

144 throw TooManyValuesException();

145 case FIFTYONE_DEGREES_RESULTS_NO_VALUE_REASON_DIFFERENCE:

146 case FIFTYONE_DEGREES_RESULTS_NO_VALUE_REASON_NO_RESULT_FOR_PROPERTY:

147 case FIFTYONE_DEGREES_RESULTS_NO_VALUE_REASON_NO_RESULTS:

148 case FIFTYONE_DEGREES_RESULTS_NO_VALUE_REASON_UNKNOWN:

149 throw NoValuesAvailableException(noValueMessage);

150 default:

151 throw NoValuesAvailableException();

152 }

153 }

154 }

155

160 void setValue(T targetValue) {

161 this->value = targetValue;

162 hasValueInternal = true;

163 }

164

173 void setNoValueReason(

174 fiftyoneDegreesResultsNoValueReason reason,

175 const char *message) {

176 this->noValueReason = reason;

177 this->noValueMessage = message;

178 }

179

192 T operator*() {

193 return getValue();

194 }

195

200 private:

201

202 bool hasValueInternal;

203 T value;

204 const char *noValueMessage = nullptr;

205 fiftyoneDegreesResultsNoValueReason noValueReason =

206 FIFTYONE_DEGREES_RESULTS_NO_VALUE_REASON_UNKNOWN;

207 };

208 }

209 }

210

211 #endif

FiftyoneDegrees::Common::Value

Encapsulates a value returned an instance of ResultsBase for a specified property.

Definition: Value.hpp:75

FiftyoneDegrees::Common::InvalidPropertyException

Exception thrown when a property does not exist in the data set.

Definition: Exceptions.hpp:118

FiftyoneDegrees::Common::Value::getValue

T getValue()

Gets the value contained in the Value instance.

Definition: Value.hpp:130

FIFTYONE_DEGREES_RESULTS_NO_VALUE_REASON_TOO_MANY_VALUES

There are too many values to be expressed as the requested type.

Definition: results.h:80

FIFTYONE_DEGREES_RESULTS_NO_VALUE_REASON_NO_RESULTS

There are no results to get a value from.

Definition: results.h:77

FiftyoneDegrees::Common::Value::getNoValueMessage

const char * getNoValueMessage()

Gets a message explaining why there is no value.

Definition: Value.hpp:120

FiftyoneDegrees

51Degrees base namespace.

Definition: ComponentMetaDataBuilderHash.hpp:34

FiftyoneDegrees::Common::Value::setNoValueReason

void setNoValueReason(fiftyoneDegreesResultsNoValueReason reason, const char *message)

Set the reason there is no value available.

Definition: Value.hpp:173

FIFTYONE_DEGREES_RESULTS_NO_VALUE_REASON_UNKNOWN

None of the above.

Definition: results.h:88

FiftyoneDegrees::Common::NoValuesAvailableException

Exception indicating that there were no values in the results for the requested property.

Definition: Exceptions.hpp:161

FIFTYONE_DEGREES_RESULTS_NO_VALUE_REASON_INVALID_PROPERTY

The requested property does not exist, or is not a required property.

Definition: results.h:65

FiftyoneDegrees::Common::Value::hasValue

bool hasValue()

Indicates whether or not a valid value has been returned by the ResultsBase instance.

Definition: Value.hpp:101

FiftyoneDegrees::Common::Value::getNoValueReason

fiftyoneDegreesResultsNoValueReason getNoValueReason()

Indicates the reason why valid values are not available.

Definition: Value.hpp:111

fiftyoneDegreesResultsNoValueReason

Enum containing reasons which cause a value to not be present or valid.

Definition: results.h:56

FiftyoneDegrees::Common::Value::Value

Value()

Default constructor.

Definition: Value.hpp:85

FIFTYONE_DEGREES_RESULTS_NO_VALUE_REASON_DIFFERENCE

The difference value is higher than the threshold, see the Pattern API.

Definition: results.h:57

FiftyoneDegrees::Common::TooManyValuesException

Exception indicating that an attempt was made to return a single value type (e.g.

Definition: Exceptions.hpp:149

FiftyoneDegrees::Common::Value::setValue

void setValue(T targetValue)

Set the value to be contained in the Value instance.

Definition: Value.hpp:160

FIFTYONE_DEGREES_RESULTS_NO_VALUE_REASON_NO_RESULT_FOR_PROPERTY

There is no result which contains a value for the requested property.

Definition: results.h:70

51Degrees Device Detection C/C++ 4.4

Value.hpp