cobject.h

//==========================================================================
//  COBJECT.H - part of
//                     OMNeT++/OMNEST
//            Discrete System Simulation in C++
//
//  Declaration of the following classes:
//    cObject : general base class
//
//==========================================================================

/*--------------------------------------------------------------*
  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 __COBJECT_H
#define __COBJECT_H

#include <string>
#include "simkerneldefs.h"
#include "simutil.h"
#include "cvisitor.h"

// Note: we include regmacros.h here in order to prevent the compiler from
// misunderstanding Register_Class() in other source files as a function declaration
#include "regmacros.h"

NAMESPACE_BEGIN

class cCommBuffer;
class cClassDescriptor;
class cOwnedObject;


class SIM_API cObject
{
    friend class cOwnedObject;
    friend class cDefaultList;

  public:
    // internal: returns a descriptor object for this object
    virtual cClassDescriptor *getDescriptor();

  protected:
    // internal
    virtual void ownedObjectDeleted(cOwnedObject *obj);

    // internal
    virtual void yieldOwnership(cOwnedObject *obj, cObject *to);

  public:
    cObject() {}

    cObject(const cObject& other) {}

    virtual ~cObject();

    virtual const char *getClassName() const;

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

    bool isName(const char *s) const {return !opp_strcmp(getName(),s);}

    virtual const char *getFullName() const  {return getName();}

    virtual std::string getFullPath() const;

    virtual std::string info() const;

    virtual std::string detailedInfo() const;

    virtual cObject *dup() const;

  protected:

    virtual void take(cOwnedObject *obj);

    virtual void drop(cOwnedObject *obj);

    void dropAndDelete(cOwnedObject *obj);

  public:
    virtual void parsimPack(cCommBuffer *buffer);

    virtual void parsimUnpack(cCommBuffer *buffer);

    virtual cObject *getOwner() const {return NULL;}

    virtual bool isOwnedObject() const {return false;}

    virtual void forEachChild(cVisitor *v);

    cObject *findObject(const char *name, bool deep=true);

    void copyNotSupported() const;
};


class noncopyable
{
  protected:
    noncopyable() {}
    ~noncopyable() {}
  private:
    // private, and in addition unimplemented (usage causes missing linker symbol)
    noncopyable(const noncopyable& x);
    const noncopyable& operator=(const noncopyable&);
};

NAMESPACE_END


#endif