192 lines
6.1 KiB
C++
192 lines
6.1 KiB
C++
/*
|
|
* Copyright (C) 2006-2016 Jacek Sieka, arnetheduck on gmail point 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., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
|
|
*/
|
|
|
|
#ifndef ADCHPP_SIMPLEXML_H
|
|
#define ADCHPP_SIMPLEXML_H
|
|
|
|
#include "Exception.h"
|
|
#include "Util.h"
|
|
|
|
namespace adchpp {
|
|
|
|
STANDARD_EXCEPTION(SimpleXMLException);
|
|
|
|
/**
|
|
* A simple XML class that loads an XML-ish structure into an internal tree
|
|
* and allows easy access to each element through a "current location".
|
|
*/
|
|
class SimpleXML : private boost::noncopyable
|
|
{
|
|
public:
|
|
ADCHPP_DLL SimpleXML(int numAttribs = 0);
|
|
ADCHPP_DLL ~SimpleXML();
|
|
|
|
ADCHPP_DLL void addTag(const std::string& aName, const std::string& aData = Util::emptyString) throw(SimpleXMLException);
|
|
void addTag(const std::string& aName, int aData) throw(SimpleXMLException) {
|
|
addTag(aName, Util::toString(aData));
|
|
}
|
|
void addTag(const std::string& aName, int64_t aData) throw(SimpleXMLException) {
|
|
addTag(aName, Util::toString(aData));
|
|
}
|
|
|
|
template<typename T>
|
|
void addAttrib(const std::string& aName, const T& aData) throw(SimpleXMLException) {
|
|
addAttrib(aName, Util::toString(aData));
|
|
}
|
|
|
|
ADCHPP_DLL void addAttrib(const std::string& aName, const std::string& aData) throw(SimpleXMLException);
|
|
|
|
template <typename T>
|
|
void addChildAttrib(const std::string& aName, const T& aData) throw(SimpleXMLException) {
|
|
addChildAttrib(aName, Util::toString(aData));
|
|
}
|
|
ADCHPP_DLL void addChildAttrib(const std::string& aName, const std::string& aData) throw(SimpleXMLException);
|
|
|
|
const std::string& getData() const {
|
|
dcassert(current != NULL);
|
|
return current->data;
|
|
}
|
|
|
|
ADCHPP_DLL void stepIn() const throw(SimpleXMLException);
|
|
ADCHPP_DLL void stepOut() const throw(SimpleXMLException);
|
|
|
|
void resetCurrentChild() const throw() {
|
|
found = false;
|
|
dcassert(current != NULL);
|
|
currentChild = current->children.begin();
|
|
}
|
|
|
|
ADCHPP_DLL bool findChild(const std::string& aName) const throw();
|
|
|
|
const std::string& getChildName() const {
|
|
checkChildSelected();
|
|
return (*currentChild)->name;
|
|
}
|
|
|
|
const std::string& getChildData() const {
|
|
checkChildSelected();
|
|
return (*currentChild)->data;
|
|
}
|
|
|
|
const std::string& getChildAttrib(const std::string& aName, const std::string& aDefault = Util::emptyString) const {
|
|
checkChildSelected();
|
|
return (*currentChild)->getAttrib(aName, aDefault);
|
|
}
|
|
|
|
int getIntChildAttrib(const std::string& aName) const {
|
|
checkChildSelected();
|
|
return Util::toInt(getChildAttrib(aName));
|
|
}
|
|
int64_t getLongLongChildAttrib(const std::string& aName) const {
|
|
checkChildSelected();
|
|
return Util::toInt64(getChildAttrib(aName));
|
|
}
|
|
bool getBoolChildAttrib(const std::string& aName) const {
|
|
checkChildSelected();
|
|
const std::string& tmp = getChildAttrib(aName);
|
|
|
|
return (tmp.size() > 0) && tmp[0] == '1';
|
|
}
|
|
|
|
ADCHPP_DLL void fromXML(const std::string& aXML) throw(SimpleXMLException);
|
|
std::string toXML() { return (!root->children.empty()) ? root->children[0]->toXML(0) : Util::emptyString; }
|
|
|
|
ADCHPP_DLL static void escape(std::string& aString, bool aAttrib, bool aLoading = false);
|
|
/**
|
|
* This is a heurestic for whether escape needs to be called or not. The results are
|
|
* only guaranteed for false, i e sometimes true might be returned even though escape
|
|
* was not needed...
|
|
*/
|
|
static bool needsEscape(const std::string& aString, bool aAttrib, bool aLoading = false) {
|
|
return ((aLoading) ? aString.find('&') : aString.find_first_of(aAttrib ? "<&>'\"" : "<&>")) != std::string::npos;
|
|
}
|
|
private:
|
|
class Tag {
|
|
public:
|
|
typedef Tag* Ptr;
|
|
typedef std::vector<Ptr> List;
|
|
typedef List::iterator Iter;
|
|
typedef std::pair<std::string, std::string> StringPair;
|
|
typedef std::vector<StringPair> AttribMap;
|
|
typedef AttribMap::iterator AttribIter;
|
|
|
|
/**
|
|
* A simple list of children. To find a tag, one must search the entire list.
|
|
*/
|
|
List children;
|
|
/**
|
|
* Attributes of this tag. According to the XML standard the names
|
|
* must be unique (case-sensitive). (Assuming that we have few attributes here,
|
|
* we use a vector instead of a (hash)map to save a few bytes of memory and unnecessary
|
|
* calls to the memory allocator...)
|
|
*/
|
|
AttribMap attribs;
|
|
|
|
/** Tag name */
|
|
std::string name;
|
|
|
|
/** Tag data, may be empty. */
|
|
std::string data;
|
|
|
|
/** Parent tag, for easy traversal */
|
|
Ptr parent;
|
|
|
|
Tag(const std::string& aName, const std::string& aData, Ptr aParent, int numAttribs = 0) : name(aName), data(aData), parent(aParent) {
|
|
if(numAttribs > 0)
|
|
attribs.reserve(numAttribs);
|
|
}
|
|
|
|
const std::string& getAttrib(const std::string& aName, const std::string& aDefault = Util::emptyString) {
|
|
AttribIter i = find_if(attribs.begin(), attribs.end(), CompareFirst<std::string, std::string>(aName));
|
|
return (i == attribs.end()) ? aDefault : i->second;
|
|
}
|
|
ADCHPP_DLL std::string toXML(int indent);
|
|
|
|
std::string::size_type fromXML(const std::string& tmp, std::string::size_type start, int aa, bool isRoot = false) throw(SimpleXMLException);
|
|
std::string::size_type loadAttribs(const std::string& tmp, std::string::size_type start) throw(SimpleXMLException);
|
|
|
|
void appendAttribString(std::string& tmp);
|
|
/** Delete all children! */
|
|
~Tag() {
|
|
for(Iter i = children.begin(); i != children.end(); ++i) {
|
|
delete *i;
|
|
}
|
|
}
|
|
};
|
|
|
|
/** Bogus root tag, should be only one child! */
|
|
Tag::Ptr root;
|
|
|
|
/** Current position */
|
|
mutable Tag::Ptr current;
|
|
|
|
mutable Tag::Iter currentChild;
|
|
|
|
void checkChildSelected() const throw() {
|
|
dcassert(current != NULL);
|
|
dcassert(currentChild != current->children.end());
|
|
}
|
|
|
|
int attribs;
|
|
mutable bool found;
|
|
};
|
|
|
|
}
|
|
|
|
#endif // SIMPLEXML_H
|