blob: 0708d341da7fb50021ee405fe7ac62b7cd3d333f (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
|
#ifndef XML_H
#define XML_H
/******************************************************************************
*
* Copyright (C) 1997-2021 by Dimitri van Heesch.
*
* Permission to use, copy, modify, and distribute this software and its
* documentation under the terms of the GNU General Public License is hereby
* granted. No representations are made about the suitability of this software
* for any purpose. It is provided "as is" without express or implied warranty.
* See the GNU General Public License for more details.
*
* Documents produced by Doxygen are derivative works derived from the
* input used in their production; they are not affected by this license.
*
*/
#include <memory>
#include <functional>
#include <string>
#include <unordered_map>
/*! @brief Event handlers that can installed by the client and called while parsing a XML document.
*/
class XMLHandlers
{
public:
using Attributes = std::unordered_map<std::string,std::string>;
using StartDocType = void();
using EndDocType = void();
using StartElementType = void(const std::string &,const Attributes &);
using EndElementType = void(const std::string &);
using ErrorType = void(const std::string,int,const std::string &);
using CharsType = void(const std::string &);
std::function<StartDocType> startDocument; /**< handler invoked at the start of the document */
std::function<EndDocType> endDocument; /**< handler invoked at the end of the document */
std::function<StartElementType> startElement; /**< handler invoked when an opening tag has been found */
std::function<EndElementType> endElement; /**< handler invoked when a closing tag has been found */
std::function<CharsType> characters; /**< handler invoked when content between tags has been found */
std::function<ErrorType> error; /**< handler invoked when the parser encounters an error */
static std::string value(const Attributes &attrib,const std::string &key)
{
auto it = attrib.find(key);
if (it!=attrib.end())
{
return it->second;
}
return "";
}
};
class XMLLocator
{
public:
virtual ~XMLLocator() {}
virtual int lineNr() const = 0;
virtual std::string fileName() const = 0;
};
/*! Very basic SAX style parser to parse XML documents. */
class XMLParser : public XMLLocator
{
public:
/*! Creates an instance of the parser object. Different instances can run on different
* threads without interference.
*
* @param handlers The event handlers passed by the client.
*/
XMLParser(const XMLHandlers &handlers);
/*! Destructor */
~XMLParser();
/*! Parses a file gives the contents of the file as a string.
* @param fileName the name of the file, used for error reporting.
* @param inputString the contents of the file as a zero terminated UTF-8 string.
* @param debugEnable indicates if debugging via -d lex is enabled or not.
*/
void parse(const char *fileName,const char *inputString,bool debugEnabled);
private:
virtual int lineNr() const override;
virtual std::string fileName() const override;
struct Private;
std::unique_ptr<Private> p;
};
#endif
|
