/usr/include/camp/detail/enummanager.hpp is in libcamp0.7-dev 0.7.1.1-1ubuntu2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 | /****************************************************************************
**
** Copyright (C) 2009-2010 TECHNOGERMA Systems France and/or its subsidiary(-ies).
** Contact: Technogerma Systems France Information (contact@technogerma.fr)
**
** This file is part of the CAMP library.
**
** CAMP is free software: you can redistribute it and/or modify
** it under the terms of the GNU Lesser General Public License as published by
** the Free Software Foundation, either version 3 of the License, or
** (at your option) any later version.
**
** CAMP is distributed in the hope that it will be useful,
** but WITHOUT ANY WARRANTY; without even the implied warranty of
** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
** GNU Lesser General Public License for more details.
**
** You should have received a copy of the GNU Lesser General Public License
** along with CAMP. If not, see <http://www.gnu.org/licenses/>.
**
****************************************************************************/
#ifndef CAMP_DETAIL_ENUMMANAGER_HPP
#define CAMP_DETAIL_ENUMMANAGER_HPP
#include <camp/config.hpp>
#include <camp/detail/observernotifier.hpp>
#ifndef Q_MOC_RUN
#include <boost/noncopyable.hpp>
#include <boost/shared_ptr.hpp>
#include <boost/multi_index_container.hpp>
#include <boost/multi_index/member.hpp>
#include <boost/multi_index/ordered_index.hpp>
#endif
#include <string>
namespace bm = boost::multi_index;
namespace camp
{
class Enum;
namespace detail
{
/**
* \brief Manages creation, storage, retrieval and destruction of metaenums
*
* camp::EnumManager is the place where all metaenums are stored and accessed.
* It consists of a singleton which is created on first use and destroyed at global exit.
*
* \sa Enum
*/
class CAMP_API EnumManager : public ObserverNotifier, boost::noncopyable
{
public:
/**
* \brief Get the unique instance of the class
*
* \return Reference to the unique instance of EnumManager
*/
static EnumManager& instance();
/**
* \brief Create and register a new metaenum
*
* This is the entry point for every metaenum creation. This
* function also notifies registered observers after successful creations.
*
* \param name Name of the metaenum to create (must be unique)
* \param id Identifier of the C++ enum bound to the metaenum
*
* \return Reference to the new metaenum
*/
Enum& addClass(const std::string& name, const std::string& id);
/**
* \brief Get the total number of metaenums
*
* \return Number of metaenums that have been registered
*/
std::size_t count() const;
/**
* \brief Get a metaenum from its global index
*
* This function, together with EnumManager::count, provides a way to iterate through
* all the metaenums that have been declared.
*
* \param index Global index of the metaenum to get
*
* \return Reference to the index-th metaenum
*
* \throw OutOfRange index is out of range
*/
const Enum& getByIndex(std::size_t index) const;
/**
* \brief Get a metaenum from its name
*
* \param name Name of the metaenum to retrieve
*
* \return Reference to the requested metaenum
*
* \throw EnumNotFound name is not the name of an existing metaenum
*/
const Enum& getByName(const std::string& name) const;
/**
* \brief Get a metaenum from a C++ type
*
* \param id Identifier of the C++ type
*
* \return Reference to the requested metaenum
*
* \throw EnumNotFound id is not the name of an existing metaenum
*/
const Enum& getById(const std::string& id) const;
/**
* \brief Get a metaenum from a C++ type
*
* This version returns a null pointer if no metaenum is found, instead
* of throwing an exception.
*
* \param id Identifier of the C++ type
*
* \return Pointer to the requested metaenum, or 0 if not found
*/
const Enum* getByIdSafe(const std::string& id) const;
/**
* \brief Check if a given type has a metaenum
*
* \param id Identifier of the C++ type
*
* \return True if the enum exists, false otherwise
*/
bool enumExists(const std::string& id) const;
private:
/**
* \brief Default constructor
*/
EnumManager();
/**
* \brief Destructor
*
* The destructor destroys all the registered metaenums and notifies the observers.
*/
~EnumManager();
/**
* \brief Structure gathering an enum, its type identifier and its name
*/
struct EnumInfo
{
std::string id;
std::string name;
boost::shared_ptr<Enum> enumPtr;
};
struct Id;
struct Name;
typedef boost::multi_index_container<EnumInfo,
bm::indexed_by<bm::ordered_unique<bm::tag<Id>, bm::member<EnumInfo, std::string, &EnumInfo::id> >,
bm::ordered_unique<bm::tag<Name>, bm::member<EnumInfo, std::string, &EnumInfo::name> >
>
> EnumTable;
typedef EnumTable::index<Id>::type IdIndex;
typedef EnumTable::index<Name>::type NameIndex;
EnumTable m_enums; ///< Table storing enums indexed by their id and name
};
} // namespace detail
} // namespace camp
#endif // CAMP_DETAIL_ENUMMANAGER_HPP
|