cproperties.h

//==========================================================================
//  CPROPERTIES.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 __CPROPERTIES_H
#define __CPROPERTIES_H

#include "simkerneldefs.h"
#include "globals.h"
#include "cobject.h"
#include <vector>

NAMESPACE_BEGIN

class cProperty;


class SIM_API cProperties : public cObject
{
  protected:
    bool islocked;
    int refcount;
    std::vector<cProperty *> propv;

  private:
    void copy(const cProperties& other);

  public:
    // internal: locks the object and all contained properties against modifications.
    // The object cannot be unlocked -- one must copy contents to an unlocked
    // object, or call dup() (new objects are created in unlocked state).
    virtual void lock();

    // internal: increment/decrement reference count
    int addRef()  {return ++refcount;}
    int removeRef()  {return --refcount;}

  public:
    explicit cProperties();

    cProperties(const cProperties& other) : cObject(other) {refcount=0; islocked=false; copy(other);}

    virtual ~cProperties();

    cProperties& operator=(const cProperties& other);

    virtual cProperties *dup() const  {return new cProperties(*this);}

    virtual const char *getName() const  {return "properties";}

    virtual std::string info() const;

    virtual void parsimPack(cCommBuffer *buffer);

    virtual void parsimUnpack(cCommBuffer *buffer);

    virtual int getNumProperties() const  {return propv.size();}

    virtual const std::vector<const char *> getNames() const;

    virtual cProperty *get(int k) const;

    virtual cProperty *get(const char *name, const char *index=NULL) const;

    virtual bool getAsBool(const char *name, const char *index=NULL) const;

    virtual std::vector<const char *> getIndicesFor(const char *name) const;

    virtual void add(cProperty *p);

    virtual void remove(int k);
};

NAMESPACE_END


#endif