coutvector.h

//==========================================================================
//  COUTVECTOR.H - part of
//                     OMNeT++/OMNEST
//            Discrete System Simulation in C++
//
//
//  Declaration of the following classes:
//    cOutVector : represents an output vector
//
//==========================================================================

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

#include <stdio.h>
#include "cownedobject.h"
#include "simtime_t.h"

NAMESPACE_BEGIN


typedef void (*RecordFunc)(void *, simtime_t, double, double);

class cEnum;


class SIM_API cOutVector : public cNoncopyableOwnedObject
{
  protected:
    enum {
      FL_ENABLED = 4,      // flag: when false, record() method will do nothing
      FL_RECORDWARMUP = 8, // flag: when set, object records data during warmup period as well
    };

    void *handle;        // identifies output vector for the output vector manager
    simtime_t last_t;    // last timestamp written, needed to ensure increasing timestamp order
    long num_received;   // total number of values passed to the output vector object
    long num_stored;     // number of values actually stored

    // the following members will be used directly by inspectors
    RecordFunc record_in_inspector; // to notify inspector about file writes
    void *data_for_inspector;

  public:
    // internal: called from behind cEnvir
    void setCallback(RecordFunc f, void *d) {record_in_inspector=f; data_for_inspector=d;}

  public:
    enum Type { TYPE_INT, TYPE_DOUBLE, TYPE_ENUM };
    enum InterpolationMode { NONE, SAMPLE_HOLD, BACKWARD_SAMPLE_HOLD, LINEAR };

  public:
    explicit cOutVector(const char *name=NULL);

    virtual ~cOutVector();


    virtual void setName(const char *name);

    virtual std::string info() const;

    virtual void parsimPack(cCommBuffer *buffer);

    virtual void parsimUnpack(cCommBuffer *buffer);

    virtual void setEnum(const char *registeredEnumName);

    virtual void setEnum(cEnum *enumDecl);

    virtual void setUnit(const char *unit);

    virtual void setType(Type type);

    virtual void setInterpolationMode(InterpolationMode mode);

    virtual void setMin(double minValue);

    virtual void setMax(double maxValue);

    virtual bool record(double value);

    virtual bool record(SimTime value)  {return record(value.dbl());}

    virtual bool recordWithTimestamp(simtime_t t, double value);

    virtual bool recordWithTimestamp(simtime_t t, SimTime value) {return recordWithTimestamp(t, value.dbl());}

    virtual void enable()  {setFlag(FL_ENABLED,true);}

    virtual void disable()  {setFlag(FL_ENABLED,false);}

    virtual void setEnabled(bool b)  {setFlag(FL_ENABLED,b);}

    virtual bool isEnabled() const  {return flags&FL_ENABLED;}

    virtual void setRecordDuringWarmupPeriod(bool b)  {setFlag(FL_RECORDWARMUP,b);}

    virtual bool getRecordDuringWarmupPeriod() const  {return flags&FL_RECORDWARMUP;}

    long getValuesReceived() const  {return num_received;}

    long getValuesStored() const  {return num_stored;}
};

NAMESPACE_END


#endif