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
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
|
/*
* Copyright (C) 2006-2016 Paul Davis <paul@linuxaudiosystems.com>
* Copyright (C) 2006 Taybin Rutkin <taybin@taybin.com>
* Copyright (C) 2008-2009 David Robillard <d@drobilla.net>
* Copyright (C) 2008 Hans Baier <hansfbaier@googlemail.com>
* Copyright (C) 2009-2011 Carl Hetherington <carl@carlh.net>
* Copyright (C) 2015-2017 Robin Gareus <robin@gareus.org>
* Copyright (C) 2016 Tim Mayberry <mojofunk@gmail.com>
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License along
* with this program; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*/
#ifndef __XML_H
#define __XML_H
/* xml++.h
* libxml++ and this file are copyright (C) 2000 by Ari Johnson, and
* are covered by the GNU Lesser General Public License, which should be
* included with libxml++ as the file COPYING.
* Modified for Ardour and released under the same terms.
*/
#include <string>
#include <vector>
#include <cstdio>
#include <cstdarg>
#include <libxml/parser.h>
#include <libxml/tree.h>
#include <boost/shared_ptr.hpp>
#include <glibmm/ustring.h>
#include "pbd/string_convert.h"
#include "pbd/libpbd_visibility.h"
class XMLTree;
class XMLNode;
class LIBPBD_API XMLProperty {
public:
XMLProperty(const std::string& n, const std::string& v = std::string());
~XMLProperty();
const std::string& name() const { return _name; }
const std::string& value() const { return _value; }
const std::string& set_value(const std::string& v) { return _value = v; }
private:
std::string _name;
std::string _value;
};
typedef std::vector<XMLNode *> XMLNodeList;
typedef std::vector<boost::shared_ptr<XMLNode> > XMLSharedNodeList;
typedef XMLNodeList::iterator XMLNodeIterator;
typedef XMLNodeList::const_iterator XMLNodeConstIterator;
typedef std::vector<XMLProperty*> XMLPropertyList;
typedef XMLPropertyList::iterator XMLPropertyIterator;
typedef XMLPropertyList::const_iterator XMLPropertyConstIterator;
class LIBPBD_API XMLTree {
public:
XMLTree();
XMLTree(const std::string& fn, bool validate = false);
XMLTree(const XMLTree*);
~XMLTree();
XMLNode* root() const { return _root; }
XMLNode* set_root(XMLNode* n) { return _root = n; }
const std::string& filename() const { return _filename; }
const std::string& set_filename(const std::string& fn) { return _filename = fn; }
int compression() const { return _compression; }
int set_compression(int);
bool read() { return read_internal(false); }
bool read(const std::string& fn) { set_filename(fn); return read_internal(false); }
bool read_and_validate() { return read_internal(true); }
bool read_and_validate(const std::string& fn) { set_filename(fn); return read_internal(true); }
bool read_buffer(char const*, bool to_tree_doc = false);
bool write() const;
bool write(const std::string& fn) { set_filename(fn); return write(); }
void debug (FILE*) const;
const std::string& write_buffer() const;
boost::shared_ptr<XMLSharedNodeList> find(const std::string xpath, XMLNode* = 0) const;
private:
bool read_internal(bool validate);
std::string _filename;
XMLNode* _root;
xmlDocPtr _doc;
int _compression;
};
class LIBPBD_API XMLNode {
public:
XMLNode(const std::string& name);
XMLNode(const std::string& name, const std::string& content);
XMLNode(const XMLNode& other);
~XMLNode();
XMLNode& operator= (const XMLNode& other);
bool operator== (const XMLNode& other) const;
bool operator!= (const XMLNode& other) const;
const std::string& name() const { return _name; }
bool is_content() const { return _is_content; }
const std::string& content() const { return _content; }
const std::string& set_content(const std::string&);
XMLNode* add_content(const std::string& s = std::string());
const XMLNodeList& children(const std::string& str = std::string()) const;
XMLNode* child(const char*) const;
XMLNode* add_child(const char *);
XMLNode* add_child_copy(const XMLNode&);
void add_child_nocopy(XMLNode&);
std::string attribute_value(); //throws XMLException if attribute doesn't exist
const XMLPropertyList& properties() const { return _proplist; }
XMLProperty const * property(const char*) const;
XMLProperty const * property(const std::string&) const;
XMLProperty * property(const char*);
XMLProperty * property(const std::string&);
bool has_property_with_value (const std::string&, const std::string&) const;
bool set_property (const char* name, const std::string& value);
bool set_property (const char* name, const char* cstr) {
return set_property (name, std::string(cstr));
}
bool set_property (const char* name, const Glib::ustring& ustr)
{
return set_property (name, ustr.raw ());
}
template<class T>
bool set_property (const char* name, const T& value)
{
std::string str;
if (!PBD::to_string<T> (value, str)) {
return false;
}
return set_property(name, str);
}
bool get_property (const char* name, std::string& value) const;
template <class T>
bool get_property (const char* name, T& value) const
{
XMLProperty const* const prop = property (name);
if (!prop) {
return false;
}
return PBD::string_to<T> (prop->value (), value);
}
void remove_property(const std::string&);
void remove_property_recursively(const std::string&);
/** Remove all nodes with the name passed to remove_nodes */
void remove_nodes (const std::string&);
/** Remove and delete all nodes with the name passed to remove_nodes */
void remove_nodes_and_delete (const std::string&);
/** Remove and delete all nodes with property prop matching val */
void remove_nodes_and_delete (const std::string& propname, const std::string& val);
/** Remove and delete first node with given name and prop matching val */
void remove_node_and_delete (const std::string& n, const std::string& propname, const std::string& val);
void dump (std::ostream &, std::string p = "") const;
private:
std::string _name;
bool _is_content;
std::string _content;
XMLNodeList _children;
XMLPropertyList _proplist;
mutable XMLNodeList _selected_children;
void clear_lists ();
};
class LIBPBD_API XMLException: public std::exception {
public:
explicit XMLException(const std::string msg) : _message(msg) {}
virtual ~XMLException() throw() {}
virtual const char* what() const throw() { return _message.c_str(); }
private:
std::string _message;
};
#endif /* __XML_H */
|
