ROOT  6.07/01
Reference Guide
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Groups Pages
List of all members | Public Member Functions | Protected Member Functions | Protected Attributes | Private Member Functions | List of all members
TXMLParser Class Referenceabstract

TXMLParser is an abstract class which interfaces with Libxml2.

Libxml2 is the XML C parser and toolkit developed for the Gnome project. The libxml library provides two interfaces to the parser, a DOM style tree interface and a SAX style event based interface. TXMLParser is parent class of TSAXParser and TDOMParser, which are a SAX interface and DOM interface of libxml.

Definition at line 30 of file TXMLParser.h.

Public Member Functions

 TXMLParser ()
 Initializes parser variables. More...
 
virtual ~TXMLParser ()
 Cleanup. More...
 
void SetValidate (Bool_t val=kTRUE)
 The parser will validate the xml file if val = true. More...
 
Bool_t GetValidate () const
 
void SetReplaceEntities (Bool_t val=kTRUE)
 The parser will replace/expand entities. More...
 
Bool_t GetReplaceEntities () const
 
virtual Int_t ParseFile (const char *filename)=0
 
virtual Int_t ParseBuffer (const char *contents, Int_t len)=0
 
virtual void StopParser ()
 Stops parsing. More...
 
Int_t GetParseCode () const
 
const char * GetParseCodeMessage (Int_t parseCode) const
 Returns the parse code message. More...
 
void SetStopOnError (Bool_t stop=kTRUE)
 Set parser stops in case of error: More...
 
Bool_t GetStopOnError () const
 
const char * GetValidateError () const
 
const char * GetValidateWarning () const
 
 ClassDef (TXMLParser, 0)
 
- Public Member Functions inherited from TObject
 TObject ()
 
 TObject (const TObject &object)
 TObject copy ctor. More...
 
TObjectoperator= (const TObject &rhs)
 TObject assignment operator. More...
 
virtual ~TObject ()
 TObject destructor. More...
 
virtual void AppendPad (Option_t *option="")
 Append graphics object to current pad. More...
 
virtual void Browse (TBrowser *b)
 Browse object. May be overridden for another default action. More...
 
virtual const char * ClassName () const
 Returns name of class to which the object belongs. More...
 
virtual void Clear (Option_t *="")
 
virtual TObjectClone (const char *newname="") const
 Make a clone of an object using the Streamer facility. More...
 
virtual Int_t Compare (const TObject *obj) const
 Compare abstract method. More...
 
virtual void Copy (TObject &object) const
 Copy this to obj. More...
 
virtual void Delete (Option_t *option="")
 Delete this object. More...
 
virtual Int_t DistancetoPrimitive (Int_t px, Int_t py)
 Computes distance from point (px,py) to the object. More...
 
virtual void Draw (Option_t *option="")
 Default Draw method for all objects. More...
 
virtual void DrawClass () const
 Draw class inheritance tree of the class to which this object belongs. More...
 
virtual TObjectDrawClone (Option_t *option="") const
 Draw a clone of this object in the current pad. More...
 
virtual void Dump () const
 Dump contents of object on stdout. More...
 
virtual void Execute (const char *method, const char *params, Int_t *error=0)
 Execute method on this object with the given parameter string, e.g. More...
 
virtual void Execute (TMethod *method, TObjArray *params, Int_t *error=0)
 Execute method on this object with parameters stored in the TObjArray. More...
 
virtual void ExecuteEvent (Int_t event, Int_t px, Int_t py)
 Execute action corresponding to an event at (px,py). More...
 
virtual TObjectFindObject (const char *name) const
 Must be redefined in derived classes. More...
 
virtual TObjectFindObject (const TObject *obj) const
 Must be redefined in derived classes. More...
 
virtual Option_tGetDrawOption () const
 Get option used by the graphics system to draw this object. More...
 
virtual UInt_t GetUniqueID () const
 Return the unique object id. More...
 
virtual const char * GetName () const
 Returns name of object. More...
 
virtual const char * GetIconName () const
 Returns mime type name of object. More...
 
virtual Option_tGetOption () const
 
virtual char * GetObjectInfo (Int_t px, Int_t py) const
 Returns string containing info about the object at position (px,py). More...
 
virtual const char * GetTitle () const
 Returns title of object. More...
 
virtual Bool_t HandleTimer (TTimer *timer)
 Execute action in response of a timer timing out. More...
 
virtual ULong_t Hash () const
 Return hash value for this object. More...
 
virtual Bool_t InheritsFrom (const char *classname) const
 Returns kTRUE if object inherits from class "classname". More...
 
virtual Bool_t InheritsFrom (const TClass *cl) const
 Returns kTRUE if object inherits from TClass cl. More...
 
virtual void Inspect () const
 Dump contents of this object in a graphics canvas. More...
 
virtual Bool_t IsFolder () const
 Returns kTRUE in case object contains browsable objects (like containers or lists of other objects). More...
 
virtual Bool_t IsEqual (const TObject *obj) const
 Default equal comparison (objects are equal if they have the same address in memory). More...
 
virtual Bool_t IsSortable () const
 
Bool_t IsOnHeap () const
 
Bool_t IsZombie () const
 
virtual Bool_t Notify ()
 This method must be overridden to handle object notification. More...
 
virtual void ls (Option_t *option="") const
 The ls function lists the contents of a class on stdout. More...
 
virtual void Paint (Option_t *option="")
 This method must be overridden if a class wants to paint itself. More...
 
virtual void Pop ()
 Pop on object drawn in a pad to the top of the display list. More...
 
virtual void Print (Option_t *option="") const
 This method must be overridden when a class wants to print itself. More...
 
virtual Int_t Read (const char *name)
 Read contents of object with specified name from the current directory. More...
 
virtual void RecursiveRemove (TObject *obj)
 Recursively remove this object from a list. More...
 
virtual void SaveAs (const char *filename="", Option_t *option="") const
 Save this object in the file specified by filename. More...
 
virtual void SavePrimitive (std::ostream &out, Option_t *option="")
 Save a primitive as a C++ statement(s) on output stream "out". More...
 
virtual void SetDrawOption (Option_t *option="")
 Set drawing option for object. More...
 
virtual void SetUniqueID (UInt_t uid)
 Set the unique object id. More...
 
virtual void UseCurrentStyle ()
 Set current style settings in this object This function is called when either TCanvas::UseCurrentStyle or TROOT::ForceStyle have been invoked. More...
 
virtual Int_t Write (const char *name=0, Int_t option=0, Int_t bufsize=0)
 Write this object to the current directory. More...
 
virtual Int_t Write (const char *name=0, Int_t option=0, Int_t bufsize=0) const
 Write this object to the current directory. More...
 
voidoperator new (size_t sz)
 
voidoperator new[] (size_t sz)
 
voidoperator new (size_t sz, void *vp)
 
voidoperator new[] (size_t sz, void *vp)
 
void operator delete (void *ptr)
 Operator delete. More...
 
void operator delete[] (void *ptr)
 Operator delete []. More...
 
void SetBit (UInt_t f, Bool_t set)
 Set or unset the user status bits as specified in f. More...
 
void SetBit (UInt_t f)
 
void ResetBit (UInt_t f)
 
Bool_t TestBit (UInt_t f) const
 
Int_t TestBits (UInt_t f) const
 
void InvertBit (UInt_t f)
 
virtual void Info (const char *method, const char *msgfmt,...) const
 Issue info message. More...
 
virtual void Warning (const char *method, const char *msgfmt,...) const
 Issue warning message. More...
 
virtual void Error (const char *method, const char *msgfmt,...) const
 Issue error message. More...
 
virtual void SysError (const char *method, const char *msgfmt,...) const
 Issue system error message. More...
 
virtual void Fatal (const char *method, const char *msgfmt,...) const
 Issue fatal error message. More...
 
void AbstractMethod (const char *method) const
 Use this method to implement an "abstract" method that you don't want to leave purely abstract. More...
 
void MayNotUse (const char *method) const
 Use this method to signal that a method (defined in a base class) may not be called in a derived class (in principle against good design since a child class should not provide less functionality than its parent, however, sometimes it is necessary). More...
 
void Obsolete (const char *method, const char *asOfVers, const char *removedFromVers) const
 Use this method to declare a method obsolete. More...
 
- Public Member Functions inherited from TQObject
 TQObject ()
 TQObject Constructor. More...
 
virtual ~TQObject ()
 TQObject Destructor. More...
 
TListGetListOfClassSignals () const
 Returns pointer to list of signals of this class. More...
 
TListGetListOfSignals () const
 
TListGetListOfConnections () const
 
Bool_t AreSignalsBlocked () const
 
Bool_t BlockSignals (Bool_t b)
 
void CollectClassSignalLists (TList &list, TClass *cls)
 Collect class signal lists from class cls and all its base-classes. More...
 
template<typename... T>
void EmitVA (const char *signal_name, Int_t, const T &...params)
 
void EmitVA (const char *signal, Int_t nargs, va_list va)=delete
 
void Emit (const char *signal)
 Acitvate signal without args. More...
 
void Emit (const char *signal, Long_t *paramArr)
 Emit a signal with a varying number of arguments, paramArr is an array of the parameters. More...
 
void Emit (const char *signal, const char *params)
 Activate signal with parameter text string. More...
 
void Emit (const char *signal, Double_t param)
 Activate signal with single parameter. More...
 
void Emit (const char *signal, Long_t param)
 Activate signal with single parameter. More...
 
void Emit (const char *signal, Long64_t param)
 Activate signal with single parameter. More...
 
void Emit (const char *signal, Bool_t param)
 
void Emit (const char *signal, Char_t param)
 
void Emit (const char *signal, UChar_t param)
 
void Emit (const char *signal, Short_t param)
 
void Emit (const char *signal, UShort_t param)
 
void Emit (const char *signal, Int_t param)
 
void Emit (const char *signal, UInt_t param)
 
void Emit (const char *signal, ULong_t param)
 
void Emit (const char *signal, ULong64_t param)
 
void Emit (const char *signal, Float_t param)
 
Bool_t Connect (const char *signal, const char *receiver_class, void *receiver, const char *slot)
 Non-static method is used to connect from the signal of this object to the receiver slot. More...
 
Bool_t Disconnect (const char *signal=0, void *receiver=0, const char *slot=0)
 Disconnects signal of this object from slot of receiver. More...
 
virtual void HighPriority (const char *signal_name, const char *slot_name=0)
 
virtual void LowPriority (const char *signal_name, const char *slot_name=0)
 
virtual Bool_t HasConnection (const char *signal_name) const
 Return true if there is any object connected to this signal. More...
 
virtual Int_t NumberOfSignals () const
 Return number of signals for this object. More...
 
virtual Int_t NumberOfConnections () const
 Return number of connections for this object. More...
 
virtual void Connected (const char *)
 
virtual void Disconnected (const char *)
 
virtual void Destroyed ()
 
virtual void ChangedBy (const char *method)
 
virtual void Message (const char *msg)
 

Protected Member Functions

virtual void InitializeContext ()
 Initialize parser parameters, such as, disactivate non-standards libxml1 features, on/off validation, clear error and warning messages. More...
 
virtual void ReleaseUnderlying ()
 To release any existing document. More...
 
virtual void OnValidateError (const TString &message)
 This function is called when an error from the parser has occured. More...
 
virtual void OnValidateWarning (const TString &message)
 This function is called when a warning from the parser has occured. More...
 
virtual void SetParseCode (Int_t code)
 Set the parse code: More...
 
- Protected Member Functions inherited from TObject
void MakeZombie ()
 
virtual void DoError (int level, const char *location, const char *fmt, va_list va) const
 Interface to ErrorHandler (protected). More...
 
- Protected Member Functions inherited from TQObject
virtual voidGetSender ()
 
virtual const char * GetSenderClassName () const
 

Protected Attributes

_xmlParserCtxt * fContext
 Parse the xml file. More...
 
Bool_t fValidate
 To validate the parse context. More...
 
Bool_t fReplaceEntities
 Replace entities. More...
 
Bool_t fStopError
 Stop when parse error occurs. More...
 
TString fValidateError
 Parse error. More...
 
TString fValidateWarning
 Parse warning. More...
 
Int_t fParseCode
 To keep track of the errorcodes. More...
 
- Protected Attributes inherited from TQObject
TListfListOfSignals
 
TListfListOfConnections
 list of signals from this object More...
 
Bool_t fSignalsBlocked
 list of connections to this object More...
 

Private Member Functions

 TXMLParser (const TXMLParser &)
 
TXMLParseroperator= (const TXMLParser &)
 

Additional Inherited Members

- Public Types inherited from TObject
enum  EStatusBits {
  kCanDelete = BIT(0), kMustCleanup = BIT(3), kObjInCanvas = BIT(3), kIsReferenced = BIT(4),
  kHasUUID = BIT(5), kCannotPick = BIT(6), kNoContextMenu = BIT(8), kInvalidObject = BIT(13)
}
 
enum  { kIsOnHeap = 0x01000000, kNotDeleted = 0x02000000, kZombie = 0x04000000, kBitMask = 0x00ffffff }
 
enum  { kSingleKey = BIT(0), kOverwrite = BIT(1), kWriteDelete = BIT(2) }
 
- Static Public Member Functions inherited from TObject
static Long_t GetDtorOnly ()
 Return destructor only flag. More...
 
static void SetDtorOnly (void *obj)
 Set destructor only flag. More...
 
static Bool_t GetObjectStat ()
 Get status of object stat flag. More...
 
static void SetObjectStat (Bool_t stat)
 Turn on/off tracking of objects in the TObjectTable. More...
 
- Static Public Member Functions inherited from TQObject
static Bool_t Connect (TQObject *sender, const char *signal, const char *receiver_class, void *receiver, const char *slot)
 Create connection between sender and receiver. More...
 
static Bool_t Connect (const char *sender_class, const char *signal, const char *receiver_class, void *receiver, const char *slot)
 This method allows to make a connection from any object of the same class to a single slot. More...
 
static Bool_t Disconnect (TQObject *sender, const char *signal=0, void *receiver=0, const char *slot=0)
 Disconnects signal in object sender from slot_method in object receiver. More...
 
static Bool_t Disconnect (const char *class_name, const char *signal, void *receiver=0, const char *slot=0)
 Disconnects "class signal". More...
 
static Bool_t AreAllSignalsBlocked ()
 Returns true if all signals are blocked. More...
 
static Bool_t BlockAllSignals (Bool_t b)
 Block or unblock all signals. Returns the previous block status. More...
 
- Static Protected Member Functions inherited from TQObject
static Bool_t ConnectToClass (TQObject *sender, const char *signal, TClass *receiver_class, void *receiver, const char *slot)
 Create connection between sender and receiver. More...
 
static Bool_t ConnectToClass (const char *sender_class, const char *signal, TClass *receiver_class, void *receiver, const char *slot)
 This method allows to make connection from any object of the same class to the receiver object. More...
 
static Int_t CheckConnectArgs (TQObject *sender, TClass *sender_class, const char *signal, TClass *receiver_class, const char *slot)
 Checking of consitency of sender/receiver methods/arguments. More...
 
static TString CompressName (const char *method_name)
 
- Static Protected Attributes inherited from TQObject
static Bool_t fgAllSignalsBlocked = kFALSE
 flag used for suppression of signals More...
 

#include <TXMLParser.h>

Inheritance diagram for TXMLParser:
[legend]

Constructor & Destructor Documentation

TXMLParser::TXMLParser ( const TXMLParser )
private
TXMLParser::TXMLParser ( )

Initializes parser variables.

Definition at line 60 of file TXMLParser.cxx.

TXMLParser::~TXMLParser ( )
virtual

Cleanup.

Definition at line 68 of file TXMLParser.cxx.

Member Function Documentation

TXMLParser::ClassDef ( TXMLParser  ,
 
)
Int_t TXMLParser::GetParseCode ( ) const
inline

Definition at line 65 of file TXMLParser.h.

const char * TXMLParser::GetParseCodeMessage ( Int_t  parseCode) const

Returns the parse code message.

Definition at line 123 of file TXMLParser.cxx.

Bool_t TXMLParser::GetReplaceEntities ( ) const
inline

Definition at line 59 of file TXMLParser.h.

Bool_t TXMLParser::GetStopOnError ( ) const
inline

Definition at line 70 of file TXMLParser.h.

Bool_t TXMLParser::GetValidate ( ) const
inline

Definition at line 56 of file TXMLParser.h.

const char* TXMLParser::GetValidateError ( ) const
inline

Definition at line 72 of file TXMLParser.h.

const char* TXMLParser::GetValidateWarning ( ) const
inline

Definition at line 73 of file TXMLParser.h.

void TXMLParser::InitializeContext ( )
protectedvirtual

Initialize parser parameters, such as, disactivate non-standards libxml1 features, on/off validation, clear error and warning messages.

Definition at line 153 of file TXMLParser.cxx.

Referenced by TSAXParser::Parse(), TDOMParser::ParseBuffer(), and TDOMParser::ParseFile().

void TXMLParser::OnValidateError ( const TString message)
protectedvirtual

This function is called when an error from the parser has occured.

Message is the parse error.

Definition at line 106 of file TXMLParser.cxx.

void TXMLParser::OnValidateWarning ( const TString message)
protectedvirtual

This function is called when a warning from the parser has occured.

Message is the parse error.

Definition at line 115 of file TXMLParser.cxx.

TXMLParser& TXMLParser::operator= ( const TXMLParser )
private
virtual Int_t TXMLParser::ParseBuffer ( const char *  contents,
Int_t  len 
)
pure virtual

Implemented in TSAXParser, and TDOMParser.

virtual Int_t TXMLParser::ParseFile ( const char *  filename)
pure virtual

Implemented in TSAXParser, and TDOMParser.

void TXMLParser::ReleaseUnderlying ( )
protectedvirtual

To release any existing document.

Reimplemented in TDOMParser.

Definition at line 93 of file TXMLParser.cxx.

Referenced by TSAXParser::Parse(), TDOMParser::ReleaseUnderlying(), TSAXParser::~TSAXParser(), and ~TXMLParser().

void TXMLParser::SetParseCode ( Int_t  errorcode)
protectedvirtual

Set the parse code:

  • 0: Parse successful
  • -1: Attempt to parse a second file while a parse is in progress
  • -2: Parse context is not created
  • -3: An error occured while parsing file
  • -4: A fatal error occured while parsing file
  • -5: Document is not well-formed

Definition at line 182 of file TXMLParser.cxx.

Referenced by TDOMParser::ParseBuffer(), TDOMParser::ParseContext(), TDOMParser::ParseFile(), and TDOMParser::ReleaseUnderlying().

void TXMLParser::SetReplaceEntities ( Bool_t  val = kTRUE)

The parser will replace/expand entities.

Definition at line 85 of file TXMLParser.cxx.

void TXMLParser::SetStopOnError ( Bool_t  stop = kTRUE)

Set parser stops in case of error:

  • stop = true, stops on error
  • stop = false, continue parsing on error...

Definition at line 192 of file TXMLParser.cxx.

void TXMLParser::SetValidate ( Bool_t  val = kTRUE)

The parser will validate the xml file if val = true.

Definition at line 77 of file TXMLParser.cxx.

Referenced by DOMRecursive().

void TXMLParser::StopParser ( )
virtual

Stops parsing.

Definition at line 167 of file TXMLParser.cxx.

Member Data Documentation

_xmlParserCtxt* TXMLParser::fContext
protected
Int_t TXMLParser::fParseCode
protected

To keep track of the errorcodes.

Definition at line 43 of file TXMLParser.h.

Referenced by GetParseCode(), TSAXParser::Parse(), SetParseCode(), and ~TXMLParser().

Bool_t TXMLParser::fReplaceEntities
protected

Replace entities.

Definition at line 39 of file TXMLParser.h.

Referenced by GetReplaceEntities(), InitializeContext(), and SetReplaceEntities().

Bool_t TXMLParser::fStopError
protected

Stop when parse error occurs.

Definition at line 40 of file TXMLParser.h.

Referenced by GetStopOnError(), and SetStopOnError().

Bool_t TXMLParser::fValidate
protected

To validate the parse context.

Definition at line 38 of file TXMLParser.h.

Referenced by GetValidate(), InitializeContext(), and SetValidate().

TString TXMLParser::fValidateError
protected

Parse error.

Definition at line 41 of file TXMLParser.h.

Referenced by GetValidateError(), InitializeContext(), and OnValidateError().

TString TXMLParser::fValidateWarning
protected

Parse warning.

Definition at line 42 of file TXMLParser.h.

Referenced by GetValidateWarning(), InitializeContext(), and OnValidateWarning().

Collaboration diagram for TXMLParser:
[legend]

The documentation for this class was generated from the following files: