diff options
| author | Mirrorbot <mirrorbot@cogarr.net> | 2025-12-27 17:53:06 -0600 |
|---|---|---|
| committer | Mirrorbot <mirrorbot@cogarr.net> | 2025-12-27 17:53:06 -0600 |
| commit | 71e94ee161447b84c0eaabf6567f8fa62262cd3e (patch) | |
| tree | 391064cc6173a6fe75069af2fdc1978af12f623e /include/IXMLWriter.h | |
| download | irrlicht-master.tar.gz irrlicht-master.tar.bz2 irrlicht-master.zip | |
Diffstat (limited to 'include/IXMLWriter.h')
| -rw-r--r-- | include/IXMLWriter.h | 77 |
1 files changed, 77 insertions, 0 deletions
diff --git a/include/IXMLWriter.h b/include/IXMLWriter.h new file mode 100644 index 0000000..bb6901e --- /dev/null +++ b/include/IXMLWriter.h @@ -0,0 +1,77 @@ +// Copyright (C) 2002-2012 Nikolaus Gebhardt
+// This file is part of the "Irrlicht Engine".
+// For conditions of distribution and use, see copyright notice in irrlicht.h
+
+#ifndef __I_XML_WRITER_H_INCLUDED__
+#define __I_XML_WRITER_H_INCLUDED__
+
+#include "IReferenceCounted.h"
+#include "irrArray.h"
+#include "irrString.h"
+
+namespace irr
+{
+namespace io
+{
+
+ //! Interface providing methods for making it easier to write XML files.
+ /** This XML Writer writes xml files using in the platform dependent
+ wchar_t format and sets the xml-encoding correspondingly. */
+ class IXMLWriter : public virtual IReferenceCounted
+ {
+ public:
+ //! Writes an xml 1.0 header.
+ /** Looks like <?xml version="1.0"?>. This should always
+ be called before writing anything other, because also the text
+ file header for unicode texts is written out with this method. */
+ virtual void writeXMLHeader() = 0;
+
+ //! Writes an xml element with maximal 5 attributes like "<foo />" or
+ //! <foo optAttr="value" />.
+ /** The element can be empty or not.
+ \param name: Name of the element
+ \param empty: Specifies if the element should be empty. Like
+ "<foo />". If You set this to false, something like this is
+ written instead: "<foo>".
+ \param attr1Name: 1st attributes name
+ \param attr1Value: 1st attributes value
+ \param attr2Name: 2nd attributes name
+ \param attr2Value: 2nd attributes value
+ \param attr3Name: 3rd attributes name
+ \param attr3Value: 3rd attributes value
+ \param attr4Name: 4th attributes name
+ \param attr4Value: 4th attributes value
+ \param attr5Name: 5th attributes name
+ \param attr5Value: 5th attributes value */
+ virtual void writeElement(const wchar_t* name, bool empty=false,
+ const wchar_t* attr1Name = 0, const wchar_t* attr1Value = 0,
+ const wchar_t* attr2Name = 0, const wchar_t* attr2Value = 0,
+ const wchar_t* attr3Name = 0, const wchar_t* attr3Value = 0,
+ const wchar_t* attr4Name = 0, const wchar_t* attr4Value = 0,
+ const wchar_t* attr5Name = 0, const wchar_t* attr5Value = 0) = 0;
+
+ //! Writes an xml element with any number of attributes
+ virtual void writeElement(const wchar_t* name, bool empty,
+ core::array<core::stringw> &names, core::array<core::stringw> &values) = 0;
+
+ //! Writes a comment into the xml file
+ virtual void writeComment(const wchar_t* comment) = 0;
+
+ //! Writes the closing tag for an element. Like "</foo>"
+ virtual void writeClosingTag(const wchar_t* name) = 0;
+
+ //! Writes a text into the file.
+ /** All occurrences of special characters such as
+ & (&), < (<), > (>), and " (") are automaticly
+ replaced. */
+ virtual void writeText(const wchar_t* text) = 0;
+
+ //! Writes a line break
+ virtual void writeLineBreak() = 0;
+ };
+
+} // end namespace io
+} // end namespace irr
+
+#endif
+
|