CMake/Source/cmXMLParser.h

121 lines
4.0 KiB
C
Raw Normal View History

/*============================================================================
CMake - Cross Platform Makefile Generator
Copyright 2000-2009 Kitware, Inc., Insight Software Consortium
2005-01-18 21:41:23 +03:00
Distributed under the OSI-approved BSD License (the "License");
see accompanying file Copyright.txt for details.
2005-01-18 21:41:23 +03:00
This software is distributed WITHOUT ANY WARRANTY; without even the
implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
See the License for more information.
============================================================================*/
2005-01-18 21:41:23 +03:00
#ifndef cmXMLParser_h
#define cmXMLParser_h
#include <cmConfigure.h> // IWYU pragma: keep
#include <string>
2005-01-18 21:41:23 +03:00
extern "C" {
void cmXMLParserStartElement(void*, const char*, const char**);
void cmXMLParserEndElement(void*, const char*);
void cmXMLParserCharacterDataHandler(void*, const char*, int);
2005-01-18 21:41:23 +03:00
}
/** \class cmXMLParser
* \brief Helper class for performing XML parsing
*
* Superclass for all XML parsers.
*/
class cmXMLParser
{
public:
cmXMLParser();
virtual ~cmXMLParser();
//! Parse given XML string
virtual int Parse(const char* string);
//! Parse given XML file
virtual int ParseFile(const char* file);
2005-01-18 21:41:23 +03:00
/**
2006-05-12 22:36:39 +04:00
* When parsing fragments of XML or streaming XML, use the following
* three methods. InitializeParser method initialize parser but does
* not perform any actual parsing. ParseChunk parses framgent of
* XML. This has to match to what was already parsed. CleanupParser
* finishes parsing. If there were errors, CleanupParser will report
* them.
2005-01-18 21:41:23 +03:00
*/
virtual int InitializeParser();
virtual int ParseChunk(const char* inputString,
2007-07-26 22:36:06 +04:00
std::string::size_type length);
2005-01-18 21:41:23 +03:00
virtual int CleanupParser();
typedef void (*ReportFunction)(int, const char*, void*);
void SetErrorCallback(ReportFunction f, void* d)
{
this->ReportCallback = f;
this->ReportCallbackData = d;
}
2005-01-18 21:41:23 +03:00
protected:
2006-05-12 22:36:39 +04:00
//! This variable is true if there was a parse error while parsing in
// chunks.
2005-01-18 21:41:23 +03:00
int ParseError;
ReportFunction ReportCallback;
void* ReportCallbackData;
2005-01-18 21:41:23 +03:00
// 1 Expat parser structure. Exists only during call to Parse().
2005-01-18 21:41:23 +03:00
void* Parser;
/**
* Called before each block of input is read from the stream to check if
* parsing is complete. Can be replaced by subclasses to change the
* terminating condition for parsing. Parsing always stops when the end of
* file is reached in the stream.
*/
2005-01-18 21:41:23 +03:00
virtual int ParsingComplete();
/**
2006-05-12 22:36:39 +04:00
* Called when a new element is opened in the XML source. Should be
* replaced by subclasses to handle each element. name = Name of new
* element. atts = Null-terminated array of attribute name/value pairs.
* Even indices are attribute names, and odd indices are values.
2005-01-18 21:41:23 +03:00
*/
virtual void StartElement(const std::string& name, const char** atts);
2006-05-12 22:36:39 +04:00
//! Called at the end of an element in the XML source opened when
// StartElement was called.
virtual void EndElement(const std::string& name);
2005-01-18 21:41:23 +03:00
//! Called when there is character data to handle.
virtual void CharacterDataHandler(const char* data, int length);
2005-01-18 21:41:23 +03:00
//! Called by Parse to report an XML syntax error.
virtual void ReportXmlParseError();
2005-01-18 21:41:23 +03:00
/** Called by ReportXmlParseError with basic error info. */
virtual void ReportError(int line, int column, const char* msg);
2005-01-18 21:41:23 +03:00
//! Utility for convenience of subclasses. Wraps isspace C library
// routine.
static int IsSpace(char c);
2005-01-18 21:41:23 +03:00
//! Send the given buffer to the XML parser.
virtual int ParseBuffer(const char* buffer, std::string::size_type length);
2005-01-18 21:41:23 +03:00
//! Send the given c-style string to the XML parser.
int ParseBuffer(const char* buffer);
/** Helps subclasses search for attributes on elements. */
static const char* FindAttribute(const char** atts, const char* attribute);
2005-01-18 21:41:23 +03:00
//! Callbacks for the expat
friend void cmXMLParserStartElement(void*, const char*, const char**);
friend void cmXMLParserEndElement(void*, const char*);
friend void cmXMLParserCharacterDataHandler(void*, const char*, int);
};
#endif