cdisplaystring.h

//==========================================================================
//   CDISPLAYSTRING.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_CDISPLAYSTRING_H
#define __OMNETPP_CDISPLAYSTRING_H
 
#include "cobject.h"
#include "cgate.h"
#include "cmodule.h"
 
namespace omnetpp {
 
 
class SIM_API cDisplayString
{
  private:
    enum { MAXARGS = 16 };  // maximum number of arguments per tag
 
    // holds one tag
    struct Tag {
       char *name;
       int numArgs;
       char *args[MAXARGS];
       Tag() {name=nullptr; numArgs=0;}
    };
 
    char *buffer = nullptr;     // holds pieces of display string (sliced with zeroes)
    char *bufferEnd = nullptr;  // points to last byte of buffer allocated
    Tag *tags = nullptr;        // table of tags
    int numTags = 0;            // number of tags
 
    mutable char *assembledString = nullptr; // cached copy of assembled display string
    mutable bool assembledStringValid = true; // if cached copy is up-to-date
 
    // needed for notifications
    cComponent *ownerComponent = nullptr;
 
  private:
    void copy(const cDisplayString& other) {parse(other.str());}
 
    // helper functions
    void doParse(const char *s);
    void doUpdateWith(const cDisplayString& ds);
    bool doSetTagArg(int tagindex, int index, const char *value);
    bool doSetTagArg(const char *tagname, int index, const char *value);
    int doInsertTag(const char *tagname, int atindex=0);
    bool doRemoveTag(int tagindex);
 
    void doParse();
    void assemble() const;
    void clearTags();
    bool pointsIntoBuffer(char *s) const {return s>=buffer && s<=bufferEnd;}
    static void strcatescaped(char *d, const char *s);
 
    // internal: called before the stored display string changes
    void beforeChange();
    // internal: called when the stored display string changes, and notifies Envir in turn.
    void afterChange();
 
  public:
    // internal:
    void setHostObject(cComponent *o) {ownerComponent=o;}
    void dump(std::ostream& out) const;
 
  public:
 
    cDisplayString() {}
 
    cDisplayString(const char *dispstr);
 
    cDisplayString(const cDisplayString& ds);
 
    ~cDisplayString();
 
    cDisplayString& operator=(const cDisplayString& ds);
 
    cDisplayString& operator=(const char *s)  {parse(s); return *this;}
 
    operator const char *() const  {return str();}
 
 
    const char *str() const;
 
    void set(const char *displaystr)  {parse(displaystr);}
 
    void parse(const char *displaystr);
 
    void updateWith(const cDisplayString& ds);
 
    void updateWith(const char *s);
 
 
    bool containsTag(const char *tagname) const;
 
    int getNumArgs(const char *tagname) const;
 
    const char *getTagArg(const char *tagname, int index) const;
 
    bool setTagArg(const char *tagname, int index, const char *value);
 
    bool setTagArg(const char *tagname, int index, long value);
 
    bool removeTag(const char *tagname);
 
 
    int getNumTags() const;
 
    const char *getTagName(int tagindex) const;
 
    int getTagIndex(const char *tagname) const;
 
    int getNumArgs(int tagindex) const;
 
    const char *getTagArg(int tagindex, int index) const;
 
    bool setTagArg(int tagindex, int index, const char *value);
 
    int insertTag(const char *tagname, int atindex=0);
 
    bool removeTag(int tagindex);
};
 
 
}  // namespace omnetpp
 
 
#endif