1 | #ifndef CONSTRAINED_VALUE_HPP___
|
---|
2 | #define CONSTRAINED_VALUE_HPP___
|
---|
3 |
|
---|
4 | /* Copyright (c) 2002,2003 CrystalClear Software, Inc.
|
---|
5 | * Use, modification and distribution is subject to the
|
---|
6 | * Boost Software License, Version 1.0. (See accompanying
|
---|
7 | * file LICENSE-1.0 or http://www.boost.org/LICENSE-1.0)
|
---|
8 | * Author: Jeff Garland
|
---|
9 | * $Date: 2004/02/26 18:26:47 $
|
---|
10 | */
|
---|
11 |
|
---|
12 | #include <boost/config.hpp>
|
---|
13 |
|
---|
14 | namespace boost {
|
---|
15 |
|
---|
16 | //! Namespace containing constrained_value template and types
|
---|
17 | namespace CV {
|
---|
18 | //! Represent a min or max violation type
|
---|
19 | enum violation_enum {min_violation, max_violation};
|
---|
20 |
|
---|
21 | //! A template to specify a constrained basic value type
|
---|
22 | /*! This template provides a quick way to generate
|
---|
23 | * an integer type with a constrained range. The type
|
---|
24 | * provides for the ability to specify the min, max, and
|
---|
25 | * and error handling policy.
|
---|
26 | *
|
---|
27 | * <b>value policies</b>
|
---|
28 | * A class that provides the range limits via the min and
|
---|
29 | * max functions as well as a function on_error that
|
---|
30 | * determines how errors are handled. A common strategy
|
---|
31 | * would be to assert or throw and exception. The on_error
|
---|
32 | * is passed both the current value and the new value that
|
---|
33 | * is in error.
|
---|
34 | *
|
---|
35 | */
|
---|
36 | template<class value_policies>
|
---|
37 | class constrained_value {
|
---|
38 | public:
|
---|
39 | typedef typename value_policies::value_type value_type;
|
---|
40 | // typedef except_type exception_type;
|
---|
41 | constrained_value(value_type value)
|
---|
42 | {
|
---|
43 | assign(value);
|
---|
44 | };
|
---|
45 | constrained_value& operator=(value_type v)
|
---|
46 | {
|
---|
47 | assign(v);
|
---|
48 | return *this;
|
---|
49 | }
|
---|
50 | //! Return the max allowed value (traits method)
|
---|
51 | static value_type max BOOST_PREVENT_MACRO_SUBSTITUTION () {return (value_policies::max)();};
|
---|
52 | //! Return the min allowed value (traits method)
|
---|
53 | static value_type min BOOST_PREVENT_MACRO_SUBSTITUTION () {return (value_policies::min)();};
|
---|
54 | //! Coerce into the representation type
|
---|
55 | operator value_type() const {return value_;};
|
---|
56 | protected:
|
---|
57 | value_type value_;
|
---|
58 | private:
|
---|
59 | void assign(value_type value)
|
---|
60 | {
|
---|
61 | //adding 1 below gets rid of a compiler warning which occurs when the
|
---|
62 | //min_value is 0 and the type is unsigned....
|
---|
63 | if (value+1 < (min)()+1) {
|
---|
64 | value_policies::on_error(value_, value, min_violation);
|
---|
65 | return;
|
---|
66 | }
|
---|
67 | if (value > (max)()) {
|
---|
68 | value_policies::on_error(value_, value, max_violation);
|
---|
69 | return;
|
---|
70 | }
|
---|
71 | value_ = value;
|
---|
72 |
|
---|
73 | }
|
---|
74 | };
|
---|
75 |
|
---|
76 | //! Template to shortcut the constrained_value policy creation process
|
---|
77 | template<typename rep_type, rep_type min_value,
|
---|
78 | rep_type max_value, class exception_type>
|
---|
79 | class simple_exception_policy
|
---|
80 | {
|
---|
81 | public:
|
---|
82 | typedef rep_type value_type;
|
---|
83 | static rep_type min BOOST_PREVENT_MACRO_SUBSTITUTION () { return min_value; };
|
---|
84 | static rep_type max BOOST_PREVENT_MACRO_SUBSTITUTION () { return max_value;};
|
---|
85 | static void on_error(rep_type, rep_type, violation_enum)
|
---|
86 | {
|
---|
87 | throw exception_type();
|
---|
88 | }
|
---|
89 | };
|
---|
90 |
|
---|
91 |
|
---|
92 |
|
---|
93 | } } //namespace CV
|
---|
94 |
|
---|
95 |
|
---|
96 |
|
---|
97 |
|
---|
98 | #endif
|
---|