2019-01-12 17:23:47 +01:00
|
|
|
/* Copyright (C) 2019 Wildfire Games.
|
2009-04-18 19:00:33 +02:00
|
|
|
* This file is part of 0 A.D.
|
|
|
|
*
|
|
|
|
* 0 A.D. 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.
|
|
|
|
*
|
|
|
|
* 0 A.D. 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 0 A.D. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
*/
|
|
|
|
|
2007-05-07 18:33:24 +02:00
|
|
|
#ifndef INCLUDED_XMLWRITER
|
|
|
|
#define INCLUDED_XMLWRITER
|
2006-04-24 01:14:18 +02:00
|
|
|
|
|
|
|
/*
|
2019-01-12 17:23:47 +01:00
|
|
|
*
|
|
|
|
*System for writing simple XML files, with human-readable formatting.
|
|
|
|
*
|
|
|
|
*Example usage:
|
|
|
|
*
|
|
|
|
* XMLWriter_File exampleFile;
|
|
|
|
* {
|
|
|
|
* XMLWriter_Element scenarioTag (exampleFile,"Scenario");
|
|
|
|
* {
|
|
|
|
* XMLWriter_Element entitiesTag (exampleFile,"Entities");
|
|
|
|
* for (...)
|
|
|
|
* {
|
|
|
|
* XMLWriter_Element entityTag (exampleFile,"Entity");
|
|
|
|
* {
|
|
|
|
* XMLWriter_Element templateTag (exampleFile,"Template");
|
|
|
|
* templateTag.Text(entity.name);
|
|
|
|
* }
|
|
|
|
* // Or equivalently:
|
|
|
|
* templateTag.Setting("Template", entity.name);
|
|
|
|
* {
|
|
|
|
* XMLWriter_Element positionTag (exampleFile,"Position");
|
|
|
|
* positionTag.Attribute("x", entity.x);
|
|
|
|
* positionTag.Attribute("y", entity.y);
|
|
|
|
* positionTag.Attribute("z", entity.z);
|
|
|
|
* }
|
|
|
|
* {
|
|
|
|
* XMLWriter_Element orientationTag (exampleFile,"Orientation");
|
|
|
|
* orientationTag.Attribute("angle", entity.angle);
|
|
|
|
* }
|
|
|
|
* }
|
|
|
|
* }
|
|
|
|
* }
|
|
|
|
* exampleFile.StoreVFS(g_VFS, "/test.xml");
|
|
|
|
*
|
|
|
|
* In general, "{ XML_Element(name); ... }" means "<name> ... </name>" -- the
|
|
|
|
* scoping braces are important to indicate where an element ends. If you don't put
|
|
|
|
* them the tag won't be closed until the object's destructor is called, usually
|
|
|
|
* when it goes out of scope.
|
|
|
|
* xml_element_.Attribute/xml_element_.Setting are templated. To support more types, alter the
|
|
|
|
* end of XMLWriter.cpp.
|
|
|
|
*/
|
2006-04-24 01:14:18 +02:00
|
|
|
|
2010-07-04 12:15:53 +02:00
|
|
|
#include "lib/file/vfs/vfs.h"
|
2006-04-24 01:14:18 +02:00
|
|
|
|
2020-11-21 12:20:29 +01:00
|
|
|
class CStr8;
|
2011-03-26 21:17:21 +01:00
|
|
|
class XMBElement;
|
|
|
|
class XMBFile;
|
2006-04-24 01:14:18 +02:00
|
|
|
class XMLWriter_Element;
|
|
|
|
|
|
|
|
class XMLWriter_File
|
|
|
|
{
|
|
|
|
public:
|
2006-12-03 18:13:22 +01:00
|
|
|
XMLWriter_File();
|
|
|
|
|
|
|
|
void SetPrettyPrint(bool enabled) { m_PrettyPrint = enabled; }
|
2006-04-24 01:14:18 +02:00
|
|
|
|
|
|
|
void Comment(const char* text);
|
|
|
|
|
2011-03-26 21:17:21 +01:00
|
|
|
void XMB(const XMBFile& file);
|
|
|
|
|
2010-07-04 12:15:53 +02:00
|
|
|
bool StoreVFS(const PIVFS& vfs, const VfsPath& pathname);
|
2020-11-21 12:20:29 +01:00
|
|
|
const CStr8& GetOutput();
|
2006-04-24 01:14:18 +02:00
|
|
|
|
|
|
|
private:
|
|
|
|
|
|
|
|
friend class XMLWriter_Element;
|
|
|
|
|
2011-03-26 21:17:21 +01:00
|
|
|
void ElementXMB(const XMBFile& file, XMBElement el);
|
|
|
|
|
2006-04-24 01:14:18 +02:00
|
|
|
void ElementStart(XMLWriter_Element* element, const char* name);
|
2010-04-30 01:22:18 +02:00
|
|
|
void ElementText(const char* text, bool cdata);
|
2006-04-24 01:14:18 +02:00
|
|
|
template <typename T> void ElementAttribute(const char* name, const T& value, bool newelement);
|
|
|
|
void ElementClose();
|
|
|
|
void ElementEnd(const char* name, int type);
|
|
|
|
|
2020-11-21 12:20:29 +01:00
|
|
|
CStr8 Indent();
|
2006-04-24 01:14:18 +02:00
|
|
|
|
2006-12-03 18:13:22 +01:00
|
|
|
bool m_PrettyPrint;
|
|
|
|
|
2020-11-21 12:20:29 +01:00
|
|
|
CStr8 m_Data;
|
2006-04-24 01:14:18 +02:00
|
|
|
int m_Indent;
|
|
|
|
XMLWriter_Element* m_LastElement;
|
|
|
|
};
|
|
|
|
|
|
|
|
class XMLWriter_Element
|
|
|
|
{
|
|
|
|
public:
|
|
|
|
XMLWriter_Element(XMLWriter_File& file, const char* name);
|
|
|
|
~XMLWriter_Element();
|
|
|
|
|
2010-04-30 01:22:18 +02:00
|
|
|
template <typename constCharPtr> void Text(constCharPtr text, bool cdata);
|
2006-04-24 01:14:18 +02:00
|
|
|
template <typename T> void Attribute(const char* name, T value) { m_File->ElementAttribute(name, value, false); }
|
|
|
|
template <typename T> void Setting(const char* name, T value) { m_File->ElementAttribute(name, value, true); }
|
|
|
|
void Close(int type);
|
|
|
|
|
|
|
|
private:
|
|
|
|
|
|
|
|
friend class XMLWriter_File;
|
|
|
|
|
|
|
|
XMLWriter_File* m_File;
|
2020-11-21 12:20:29 +01:00
|
|
|
CStr8 m_Name;
|
2006-04-24 01:14:18 +02:00
|
|
|
int m_Type;
|
|
|
|
};
|
|
|
|
|
2007-05-07 18:33:24 +02:00
|
|
|
#endif // INCLUDED_XMLWRITER
|