TXMLEngine-

TXMLEngine class is used to write and read ROOT XML files - TXMLFile.

It does not conform to complete xml standard and cannot be used as parser for arbitrary XML files. For such cases TXMLParser should be used. This class was introduced to exclude dependency from external libraries (like libxml2) and improve speed / memory consumption.

class TXMLEngine : public TObject

class

protected:
   char *Makestr(const char *str);
   char *Makenstr(const char *start, int len);
   XMLNodePointer_t AllocateNode(int namelen, XMLNodePointer_t parent);
   XMLAttrPointer_t AllocateAttr(int namelen, int valuelen, XMLNodePointer_t xmlnode);
   XMLNsPointer_t FindNs(XMLNodePointer_t xmlnode, const char *nsname);
   void TruncateNsExtension(XMLNodePointer_t xmlnode);
   void UnpackSpecialCharacters(char *target, const char *source, int srclen);
   void OutputValue(char *value, TXMLOutputStream *out);
   void SaveNode(XMLNodePointer_t xmlnode, TXMLOutputStream *out, Int_t layout, Int_t level);
   XMLNodePointer_t ReadNode(XMLNodePointer_t xmlparent, TXMLInputStream *inp, Int_t &resvalue);
   void DisplayError(Int_t error, Int_t linenumber);
   XMLDocPointer_t ParseStream(TXMLInputStream *input);

   Bool_t fSkipComments; //! if true, do not create comments nodes in document during parsing

public:
   TXMLEngine();
   virtual ~TXMLEngine();

   void SetSkipComments(Bool_t on = kTRUE) { fSkipComments = on; }
   Bool_t GetSkipComments() const { return fSkipComments; }

   Bool_t HasAttr(XMLNodePointer_t xmlnode, const char *name);
   const char *GetAttr(XMLNodePointer_t xmlnode, const char *name);
   Int_t GetIntAttr(XMLNodePointer_t node, const char *name);
   XMLAttrPointer_t NewAttr(XMLNodePointer_t xmlnode, XMLNsPointer_t, const char *name, const char *value);
   XMLAttrPointer_t NewIntAttr(XMLNodePointer_t xmlnode, const char *name, Int_t value);
   void FreeAttr(XMLNodePointer_t xmlnode, const char *name);
   void FreeAllAttr(XMLNodePointer_t xmlnode);
   XMLAttrPointer_t GetFirstAttr(XMLNodePointer_t xmlnode);
   XMLAttrPointer_t GetNextAttr(XMLAttrPointer_t xmlattr);
   const char *GetAttrName(XMLAttrPointer_t xmlattr);
   const char *GetAttrValue(XMLAttrPointer_t xmlattr);
   XMLNodePointer_t NewChild(XMLNodePointer_t parent, XMLNsPointer_t ns, const char *name, const char *content = 0);
   XMLNsPointer_t NewNS(XMLNodePointer_t xmlnode, const char *reference, const char *name = 0);
   XMLNsPointer_t GetNS(XMLNodePointer_t xmlnode);
   const char *GetNSName(XMLNsPointer_t ns);
   const char *GetNSReference(XMLNsPointer_t ns);
   void AddChild(XMLNodePointer_t parent, XMLNodePointer_t child);
   void AddChildFirst(XMLNodePointer_t parent, XMLNodePointer_t child);
   Bool_t AddComment(XMLNodePointer_t parent, const char *comment);
   Bool_t AddDocComment(XMLDocPointer_t xmldoc, const char *comment);
   Bool_t AddRawLine(XMLNodePointer_t parent, const char *line);
   Bool_t AddDocRawLine(XMLDocPointer_t xmldoc, const char *line);
   Bool_t AddStyleSheet(XMLNodePointer_t parent, const char *href, const char *type = "text/css", const char *title = 0,
                        int alternate = -1, const char *media = 0, const char *charset = 0);
   Bool_t AddDocStyleSheet(XMLDocPointer_t xmldoc, const char *href, const char *type = "text/css",
                           const char *title = 0, int alternate = -1, const char *media = 0, const char *charset = 0);
   void UnlinkNode(XMLNodePointer_t node);
   void FreeNode(XMLNodePointer_t xmlnode);
   void UnlinkFreeNode(XMLNodePointer_t xmlnode);
   const char *GetNodeName(XMLNodePointer_t xmlnode);
   const char *GetNodeContent(XMLNodePointer_t xmlnode);
   void SetNodeContent(XMLNodePointer_t xmlnode, const char *content, Int_t len = 0);
   void AddNodeContent(XMLNodePointer_t xmlnode, const char *content, Int_t len = 0);
   XMLNodePointer_t GetChild(XMLNodePointer_t xmlnode, Bool_t realnode = kTRUE);
   XMLNodePointer_t GetParent(XMLNodePointer_t xmlnode);
   XMLNodePointer_t GetNext(XMLNodePointer_t xmlnode, Bool_t realnode = kTRUE);
   void ShiftToNext(XMLNodePointer_t &xmlnode, Bool_t realnode = kTRUE);
   Bool_t IsXmlNode(XMLNodePointer_t xmlnode);
   Bool_t IsEmptyNode(XMLNodePointer_t xmlnode);
   Bool_t IsContentNode(XMLNodePointer_t xmlnode);
   Bool_t IsCommentNode(XMLNodePointer_t xmlnode);
   void SkipEmpty(XMLNodePointer_t &xmlnode);
   void CleanNode(XMLNodePointer_t xmlnode);
   XMLDocPointer_t NewDoc(const char *version = "1.0");
   void AssignDtd(XMLDocPointer_t xmldoc, const char *dtdname, const char *rootname);
   void FreeDoc(XMLDocPointer_t xmldoc);
   void SaveDoc(XMLDocPointer_t xmldoc, const char *filename, Int_t layout = 1);
   void DocSetRootElement(XMLDocPointer_t xmldoc, XMLNodePointer_t xmlnode);
   XMLNodePointer_t DocGetRootElement(XMLDocPointer_t xmldoc);
   XMLDocPointer_t ParseFile(const char *filename, Int_t maxbuf = 100000);
   XMLDocPointer_t ParseString(const char *xmlstring);
   Bool_t ValidateVersion(XMLDocPointer_t doc, const char *version = 0);
   Bool_t ValidateDocument(XMLDocPointer_t, Bool_t = kFALSE) { return kFALSE; } // obsolete
   void SaveSingleNode(XMLNodePointer_t xmlnode, TString *res, Int_t layout = 1);
   XMLNodePointer_t ReadSingleNode(const char *src);