cconfigoption.h Source File¶

API: cconfigoption.h Source File
API
//==========================================================================
//  CCONFIGOPTION.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_CCONFIGOPTION_H
#define __OMNETPP_CCONFIGOPTION_H
 
#include <string>
#include "cownedobject.h"
 
namespace omnetpp {
class SIM_API cConfigOption : public cNoncopyableOwnedObject
{
  public:
    enum Type {
      CFG_BOOL,
      CFG_INT,
      CFG_DOUBLE,
      CFG_STRING,
      CFG_FILENAME,
      CFG_FILENAMES,
      CFG_PATH,
      CFG_CUSTOM
    };
    enum ObjectKind {
        KIND_NONE,
        KIND_COMPONENT,
        KIND_CHANNEL,
        KIND_MODULE,
        KIND_SIMPLE_MODULE,
        KIND_UNSPECIFIED_TYPE, // for 'typename' option (object is submodule/channel declared with 'like')
        KIND_PARAMETER,
        KIND_STATISTIC,
        KIND_SCALAR,
        KIND_VECTOR,
        KIND_OTHER
    };
 
    // note: option name (e.g. "sim-time-limit") is stored in object's name field
    bool isPerObject_;         // if true, entries must be in <object-full-path>.config-name format
    bool isGlobal_;            // if true, entries may only occur in the [General] section
    ObjectKind objectKind;     // kind of the object if isPerObject is true, KIND_NONE otherwise
    Type type;                 // option data type
    std::string unit;          // if numeric, its unit ("s") or empty string
    std::string defaultValue;  // the default value in string form
    std::string description;   // help text
 
  public:
    cConfigOption(const char *name, bool isGlobal, Type type, const char *unit,
               const char *defaultValue, const char *description);
    cConfigOption(const char *name, ObjectKind kind, Type type, const char *unit,
               const char *defaultValue, const char *description);
    virtual std::string str() const override;
    bool isPerObject() const {return isPerObject_;}
    bool isGlobal() const  {return isGlobal_;}
    ObjectKind getObjectKind() const {return objectKind;}
    static const char *getObjectKindName(ObjectKind kind);
    Type getType() const  {return type;}
    static const char *getTypeName(Type type);
    const char *getUnit() const  {return unit.empty() ? nullptr : unit.c_str();}
    const char *getDefaultValue() const  {return defaultValue.empty() ? nullptr : defaultValue.c_str();}
    const char *getDescription() const  {return description.c_str();}
    static cConfigOption *find(const char *name);
    static cConfigOption *get(const char *name);
};
 
}  // namespace omnetpp
 
 
#endif
 
 