cconfigoption.h

//==========================================================================
//  CCONFIGOPTION.H - part of
//                     OMNeT++/OMNEST
//            Discrete System Simulation in C++
//
//==========================================================================

/*--------------------------------------------------------------*
  Copyright (C) 1992-2008 Andras Varga
  Copyright (C) 2006-2008 OpenSim Ltd.

  This file is distributed WITHOUT ANY WARRANTY. See the file
  `license' for details on this and other legal matters.
*--------------------------------------------------------------*/

#ifndef __CCONFIGOPTION_H
#define __CCONFIGOPTION_H

#include <string>
#include "cownedobject.h"

NAMESPACE_BEGIN


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_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 info() const;

    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() ? NULL : unit_.c_str();}

    const char *getDefaultValue() const  {return defaultValue_.empty() ? NULL : defaultValue_.c_str();}

    const char *getDescription() const  {return description_.c_str();}
};

NAMESPACE_END


#endif