root/src/MarkupWriter.h

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
////////////////////////////////////////////////////////////////////////
// Copyright (c) Nehmulos 2011-2014
// This file is part of N0 Strain Serialization Library.
//
// N0Strain-Serialization-Library is free software: you can redistribute it and/or modify
// it under the terms of the GNU Lesser General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// N0Strain-Serialization-Library 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 Lesser General Public License for more details.
//
// You should have received a copy of the GNU Lesser General Public License
// along with N0Strain-Serialization-Library.  If not, see https://gnu.org/licenses/lgpl-3.0
////////////////////////////////////////////////////////////////////////




#pragma once

#include "Writer.h"
#include <stack>


namespace nw
{

class MarkupWriter: public nw::Writer
{
public:
        MarkupWriter(std::ostream& output);
        MarkupWriter(const String filepath);
        virtual ~MarkupWriter();

        /// open new file on given path, delete if already exists
        /// @return true if file was created, false on error
        bool openFile(const String filepath);

        /// MarkupWriter is lazy, it will just write something when you call Close.
        /// close() is also called by the destructor if it wasn't called before
        /// don't do anything if there is no valid open file
        virtual void close();

        /// Returns true. Always. It does nothing else.
        bool isInWriteMode();

        /// Returns a reference to its children
        std::vector<Tag*>& getChildren();

        /// Adds a new valueless tag that should be used to contain other tags.
        bool push(const String tagName);
        /// Adds a New Tag with the ArrayName and prepares enterNextElement with elementsName and size
        void describeArray(const String arrayName, const String elementsName, unsigned int size);
        void describeValueArray(const String arrayName, unsigned int size);
        /// Creates a new Tag with elementsName on each call, returns true if it was often called than size
        bool enterNextElement(unsigned int iterator);

        /* Serialize functions */
        void describeName(const String name);
        void describeValueConst(const bool&);                  ///< Adds a Tag to the currentTag
        void describeValueConst(const char&);                  ///< Adds a Tag to the currentTag
        void describeValueConst(const unsigned char&);         ///< Adds a Tag to the currentTag
        void describeValueConst(const signed char&);           ///< Adds a Tag to the currentTag
        void describeValueConst(const short&);                 ///< Adds a Tag to the currentTag
        void describeValueConst(const unsigned short&);    	   ///< Adds a Tag to the currentTag
        void describeValueConst(const int&);                   ///< Adds a Tag to the currentTag
        void describeValueConst(const unsigned int&);          ///< Adds a Tag to the currentTag
        void describeValueConst(const long&);                  ///< Adds a Tag to the currentTag
        void describeValueConst(const unsigned long&);         ///< Adds a Tag to the currentTag
        void describeValueConst(const float&);                 ///< Adds a Tag to the currentTag
        void describeValueConst(const Pointer);                ///< Adds a Tag to the currentTag
        void describeValueConst(const double&);                ///< Adds a Tag to the currentTag
        void describeValueConst(const long long&);             ///< Adds a Tag to the currentTag
        void describeValueConst(const long double&);           ///< Adds a Tag to the currentTag
        void describeValueConst(const String&);                ///< Adds a Tag to the currentTag
        void describeBlobConst(const String childName,nw::Pointer binaryBlob, unsigned int blobSize); ///< Adds a Tag with a base64 encoded Value
        void comment(const String text);                                                        ///< Adds a comment Tag to the currentTag

        Tag* getCurrentTag(); ///< Returns the currently opened Tag
        Tag* getMotherTag(); ///< Returns the highest tag from the hirarchy

        void pop();                      ///< Closes the currently open Tag

        /// The Name of the Tag that will be used as motherTag.
        /// By Default "N0Slib" is used as Propaganda.
        static String motherTagName;

protected:
        Tag* currentTag;
        Tag* selectedTag;
        Tag* motherTag; ///< The lowest tag in the hirarchy, also known as root
        std::vector<Tag*> states;
        std::stack<MetaArray> openArrays;
        std::ostream& output;
        bool didWrite;

        virtual void writeToOutput() = 0;

        template<class T>
        inline void addTag(T& ref);
        inline void addTag(String& ref);
private:
        std::fstream file;
};

}