cxmlelement.h

//==========================================================================
//  CXMLELEMENT.H - part of
//                     OMNeT++/OMNEST
//            Discrete System Simulation in C++
//
// Contents:
//   class cXMLElement
//
//==========================================================================

/*--------------------------------------------------------------*
  Copyright (C) 2002-2005 Andras Varga

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

#ifndef __CXMLELEMENT_H
#define __CXMLELEMENT_H

#include <string>
#include <map>
#include <vector>
#include "defs.h"

class cXMLElement;

typedef std::vector<cXMLElement*> cXMLElementList;

typedef std::map<std::string,std::string> cXMLAttributeMap;


// TBD if namespaces are supported by Expat & libxml in an easy way, maybe do it here
class SIM_API cXMLElement
{
  private:
    std::string ename;
    std::string srcloc;
    std::string value;
    cXMLAttributeMap attrs;
    cXMLElement *parent;
    cXMLElement *firstchild;
    cXMLElement *lastchild;
    cXMLElement *prevsibling;
    cXMLElement *nextsibling;

  private:
     void doGetElementsByTagName(const char *tagname, cXMLElementList& list) const;

  public:
    // internal: Constructor
    cXMLElement(const char *tagname, const char *srcloc, cXMLElement *parent);

    // internal: sets text node within element
    virtual void setNodeValue(const char *s, int len);

    // internal: appends to text node within element
    virtual void appendNodeValue(const char *s, int len);

    // internal: Destructor. Destroys children too.
    virtual ~cXMLElement();

    // internal: Sets the value of the attribute with the given name.
    virtual void setAttribute(const char *attr, const char *value);

    // internal: Appends the given element at the end of the child element list.
    virtual void appendChild(cXMLElement *node);

    // internal: Inserts the given element just before the specified child element
    // in the child element list. The where element must be a child of this element.
    virtual void insertChildBefore(cXMLElement *where, cXMLElement *newnode);

    // internal: Removes the given element from the child element list.
    // The pointer passed should be a child of this element.
    virtual cXMLElement *removeChild(cXMLElement *node);

    // internal: matches from root element
    static cXMLElement *getDocumentElementByPath(cXMLElement *documentnode, const char *pathexpr);


    virtual const char *getTagName() const;

    virtual const char *getSourceLocation() const;

    virtual const char *getNodeValue() const;

    virtual const char *getAttribute(const char *attr) const;

    virtual bool hasAttributes() const;

    virtual const cXMLAttributeMap& getAttributes() const;

    virtual cXMLElement *getParentNode() const;

    virtual bool hasChildren() const;

    virtual cXMLElement *getFirstChild() const;

    virtual cXMLElement *getLastChild() const;

    virtual cXMLElement *getNextSibling() const;

    virtual cXMLElement *getPreviousSibling() const;

    virtual cXMLElementList getChildren() const;

    virtual cXMLElementList getChildrenByTagName(const char *tagname) const;

    virtual cXMLElementList getElementsByTagName(const char *tagname);

    cXMLElement *getFirstChildWithAttribute(const char *tagname, const char *attr, const char *attrvalue=NULL) const;

    cXMLElement *getElementById(const char *idattrvalue);

    cXMLElement *getElementByPath(const char *pathexpression);

    void debugDump(int depth=0) const;
};

#endif

---