TXMLEngine

class TXMLEngine : public TObject

    protected:

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

    public:

                       TXMLEngine()
                       TXMLEngine(const TXMLEngine&)
               virtual ~TXMLEngine()
                  void AddChild(XMLNodePointer_t parent, XMLNodePointer_t child)
                  void AssignDtd(XMLDocPointer_t xmldoc, const char* dtdname, const char* rootname)
        static TClass* Class()
                  void CleanNode(XMLNodePointer_t xmlnode)
      XMLNodePointer_t DocGetRootElement(XMLDocPointer_t xmldoc)
                  void DocSetRootElement(XMLDocPointer_t xmldoc, XMLNodePointer_t xmlnode)
                  void FreeAttr(XMLNodePointer_t xmlnode, const char* name)
                  void FreeDoc(XMLDocPointer_t xmldoc)
                  void FreeNode(XMLNodePointer_t xmlnode)
           const char* GetAttr(XMLNodePointer_t xmlnode, const char* name) const
      XMLNodePointer_t GetChild(XMLNodePointer_t xmlnode)
                 Int_t GetIntAttr(XMLNodePointer_t node, const char* name)
      XMLNodePointer_t GetNext(XMLNodePointer_t xmlnode)
           const char* GetNodeContent(XMLNodePointer_t xmlnode) const
           const char* GetNodeName(XMLNodePointer_t xmlnode) const
      XMLNodePointer_t GetParent(XMLNodePointer_t xmlnode)
                Bool_t HasAttr(XMLNodePointer_t xmlnode, const char* name)
       virtual TClass* IsA() const
                Bool_t IsEmptyNode(XMLNodePointer_t)
      XMLAttrPointer_t NewAttr(XMLNodePointer_t xmlnode, XMLNsPointer_t, const char* name, const char* value)
      XMLNodePointer_t NewChild(XMLNodePointer_t parent, XMLNsPointer_t ns, const char* name, const char* content = "0")
       XMLDocPointer_t NewDoc(const char* version = "0")
      XMLAttrPointer_t NewIntAttr(XMLNodePointer_t xmlnode, const char* name, Int_t value)
        XMLNsPointer_t NewNS(XMLNodePointer_t xmlnode, const char* reference, const char* name = "0")
           TXMLEngine& operator=(const TXMLEngine&)
       XMLDocPointer_t ParseFile(const char* filename)
      XMLNodePointer_t ReadSingleNode(const char* src)
                  void SaveDoc(XMLDocPointer_t xmldoc, const char* filename, Int_t layout = 1)
                  void SaveSingleNode(XMLNodePointer_t xmlnode, TString* res, Int_t layout = 1)
                  void ShiftToNext(XMLNodePointer_t& xmlnode)
          virtual void ShowMembers(TMemberInspector& insp, char* parent)
                  void SkipEmpty(XMLNodePointer_t&)
          virtual void Streamer(TBuffer& b)
                  void StreamerNVirtual(TBuffer& b)
                  void UnlinkFreeNode(XMLNodePointer_t xmlnode)
                  void UnlinkNode(XMLNodePointer_t node)
                Bool_t ValidateDocument(XMLDocPointer_t, Bool_t = kFALSE)

Data Members

Class Description

  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.

________________________________________________________________________

 default (normal) constructor of TXMLEngine class

 destructor for TXMLEngine object

 checks if node has attribute of specified name

 returns value of attribute for xmlnode

 returns value of attribute as integer

 creates new attribute for xmlnode,
 namespaces are not supported for attributes

 create node attribute with integer value

 remove attribute from xmlnode

 create new child element for parent node

 create namespace attribute for xmlnode.
 namespace attribute will be always the first in list of node attributes

 add child element to xmlnode

 unlink (dettach) xml node from parent

 release all memory, allocated fro this node and
 destroyes node itself

 combined operation. Unlink node and free used memory

 returns name of xmlnode

 get contents (if any) of xml node

 returns first child of xml node

 returns parent of xmlnode

 return next to xmlnode node

 shifts specified node to next

 remove all childs node from xmlnode

 creates new xml document with provided version

 assignes dtd filename to document

 frees allocated document data and deletes document itself

 store document content to file
 if layout<=0, no any spaces or newlines will be placed between
 xmlnodes. Xml file will have minimum size, but nonreadable structure
 if (layout>0) each node will be started from new line,
 and number of spaces will correspond to structure depth.

 set main (root) node for document

 returns root node of document

 parses content of file and tries to produce xml structures

 convert single xml node (and its child node) to string
 if layout<=0, no any spaces or newlines will be placed between
 xmlnodes. Xml file will have minimum size, but nonreadable structure
 if (layout>0) each node will be started from new line,
 and number of spaces will correspond to structure depth.

 read snigle xml node from provided string

 creates char* variable with copy of provided string

 creates char* variable with copy of len symbols from provided string

 Allocates new xml node with specified namelength

 Allocate new attribute with specified name length and value length

 define if namespace of that name exists for xmlnode

 removes namespace extension of nodename

 unpack special symbols, used in xml syntax to code characters
 these symbols: '<' - &lt, '>' - &gt, '&' - &amp, '"' - &quot

 output value to output stream
 if symbols '<' '&' '>' '"' appears in the string, they
 will be encoded to appropriate xml symbols: &lt, &amp, &gt, &quot

 stream data of xmlnode to output

 Tries to construct xml node from input stream. Node should be
 child of xmlparent node or it can be closing tag of xmlparent.
 resvalue <= 0 if error
 resvalue == 1 if this is endnode of parent
 resvalue == 2 if this is child

 Dsiplays error, occured during parsing of xml file

Inline Functions

             Bool_t IsEmptyNode(XMLNodePointer_t)
               void SkipEmpty(XMLNodePointer_t&)
             Bool_t ValidateDocument(XMLDocPointer_t, Bool_t = kFALSE)
            TClass* Class()
            TClass* IsA() const
               void ShowMembers(TMemberInspector& insp, char* parent)
               void Streamer(TBuffer& b)
               void StreamerNVirtual(TBuffer& b)
         TXMLEngine TXMLEngine(const TXMLEngine&)
        TXMLEngine& operator=(const TXMLEngine&)