blob: 6756e2498de1806a5c233a0354c1774c36f0fd3c [file] [log] [blame]
Neale Ranns812ed392017-10-16 04:20:13 -07001/*
2 * Copyright (c) 2017 Cisco and/or its affiliates.
3 * Licensed under the Apache License, Version 2.0 (the "License");
4 * you may not use this file except in compliance with the License.
5 * You may obtain a copy of the License at:
6 *
7 * http://www.apache.org/licenses/LICENSE-2.0
8 *
9 * Unless required by applicable law or agreed to in writing, software
10 * distributed under the License is distributed on an "AS IS" BASIS,
11 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12 * See the License for the specific language governing permissions and
13 * limitations under the License.
14 */
15
16#ifndef __VOM_ENUM_H__
17#define __VOM_ENUM_H__
18
19#include <string>
20
21namespace VOM {
22/**
23 * A template base class for all enum types.
24 * This enum type exists to associate an enum value with a string for
25 * display/debug purposes.
26 * Concrete enum types use the CRTP. Derived classes thus inherit this
27 * base's function, but are not polymorphic.
28 */
29template <typename T>
30class enum_base
31{
32public:
33 /**
Neale Rannsbc3c1262017-11-10 04:03:08 -080034 * convert to string format for debug purposes
35 */
Neale Ranns812ed392017-10-16 04:20:13 -070036 const std::string& to_string() const { return (m_desc); }
37
38 /**
Neale Rannsbc3c1262017-11-10 04:03:08 -080039 * Comparison operator
40 */
Neale Ranns812ed392017-10-16 04:20:13 -070041 bool operator==(const enum_base& e) const { return (e.m_value == m_value); }
42
43 /**
Neale Rannsbc3c1262017-11-10 04:03:08 -080044 * Assignment
45 */
Neale Ranns812ed392017-10-16 04:20:13 -070046 enum_base& operator=(const enum_base& e)
47 {
48 m_value = e.m_value;
49 m_desc = e.m_desc;
50
51 return (*this);
52 }
53
54 /**
Neale Rannsbc3c1262017-11-10 04:03:08 -080055 * Comparison operator
56 */
Neale Ranns812ed392017-10-16 04:20:13 -070057 bool operator!=(const enum_base& e) const { return (e.m_value != m_value); }
58
59 /**
Neale Rannsbc3c1262017-11-10 04:03:08 -080060 * integer conversion operator
61 */
62 operator int() const { return (m_value); }
Neale Ranns812ed392017-10-16 04:20:13 -070063
64 /**
Neale Rannsbc3c1262017-11-10 04:03:08 -080065 * Return the value of the enum - same as integer conversion
66 */
67 int value() const { return (m_value); }
Neale Ranns812ed392017-10-16 04:20:13 -070068
69protected:
70 /**
Neale Rannsbc3c1262017-11-10 04:03:08 -080071 * Constructor of an enum - takes value and string description
72 */
73 enum_base(int value, const std::string desc)
Neale Ranns812ed392017-10-16 04:20:13 -070074 : m_value(value)
75 , m_desc(desc)
76 {
77 }
78
79 /**
Neale Rannsbc3c1262017-11-10 04:03:08 -080080 * Constructor
81 */
Neale Ranns812ed392017-10-16 04:20:13 -070082 virtual ~enum_base() {}
83
84private:
85 /**
Neale Rannsbc3c1262017-11-10 04:03:08 -080086 * Integer value of the enum
87 */
Neale Ranns812ed392017-10-16 04:20:13 -070088 int m_value;
89
90 /**
Neale Rannsbc3c1262017-11-10 04:03:08 -080091 * String description
92 */
Neale Ranns812ed392017-10-16 04:20:13 -070093 std::string m_desc;
94};
95};
96
97/*
98 * fd.io coding-style-patch-verification: ON
99 *
100 * Local Variables:
101 * eval: (c-set-style "mozilla")
102 * End:
103 */
104
105#endif