cenum.h Source File¶

API: cenum.h Source File
API
//==========================================================================
//  CENUM.H - part of
//                     OMNeT++/OMNEST
//            Discrete System Simulation in C++
//
//==========================================================================
 
/*--------------------------------------------------------------*
  Copyright (C) 1992-2017 Andras Varga
  Copyright (C) 2006-2017 OpenSim Ltd.
 
  This file is distributed WITHOUT ANY WARRANTY. See the file
  `license' for details on this and other legal matters.
*--------------------------------------------------------------*/
 
#ifndef __OMNETPP_CENUM_H
#define __OMNETPP_CENUM_H
 
#include <initializer_list>
#include "cownedobject.h"
 
namespace omnetpp {
class SIM_API cEnum : public cOwnedObject
{
  private:
     std::map<intval_t,std::string> valueToNameMap;
     std::map<std::string,intval_t> nameToValueMap;
     std::vector<std::string> tmpNames;
 
  private:
     void copy(const cEnum& other);
 
  public:
    // internal: helper for the Register_Enum() macro
    cEnum *registerNames(const char *nameList);
 
    template<typename T>
    cEnum *registerValues(const std::initializer_list<T>& values) {
        int i = 0;
        for (T value : values)
            insert((intval_t)value, tmpNames[i++].c_str());
        tmpNames.clear();
        return this;
    }
 
    template<typename T>
    void addPairs(const std::initializer_list<std::pair<const char*,T>> pairList) {
        for (const auto& pair : pairList)
            insert((intval_t)pair.second, pair.first);
    }
 
    // internal: helper for obsolete macro Register_Enum2()
    // usage example: e.bulkInsert("IDLE", IDLE, "BUSY", BUSY, nullptr);
    [[deprecated("Use Register_Enum_Custom() macro instead of Register_Enum2()")]]
    void bulkInsert(const char *name1, ...);
 
  public:
    explicit cEnum(const char *name=nullptr);
    cEnum(const cEnum& cenum);
    virtual ~cEnum() {}
    cEnum& operator=(const cEnum& list);
    virtual cEnum *dup() const override  {return new cEnum(*this);}
    virtual std::string str() const override;
    void insert(intval_t value, const char *name);
    const char *getStringFor(intval_t value);
    intval_t lookup(const char *name, intval_t fallback=-1);
    intval_t resolve(const char *name);
    template<typename E>
    static E resolveName(const char *name) {
        cEnum *e = get(opp_typename(typeid(E)));
        return static_cast<E>(e->resolve(name));
    }
    template<typename E>
    static const char *getNameForValue(E value) {
        cEnum *e = get(opp_typename(typeid(E)));
        return e->getStringFor(static_cast<int>(value));
    }
    const std::map<std::string,intval_t>& getNameValueMap() const {return nameToValueMap;}
    static cEnum *find(const char *enumName, const char *contextNamespace=nullptr);
    static cEnum *get(const char *enumName, const char *contextNamespace=nullptr);
};
 
}  // namespace omnetpp
 
 
#endif
 