GH-1047 parse world files and integrate MCEdit with world page

depends/libnbtplusplus/include/io/stream_reader.h

@@ -0,0 +1,138 @@
+/*
+ * libnbt++ - A library for the Minecraft Named Binary Tag format.
+ * Copyright (C) 2013, 2015  ljfa-ag
+ *
+ * This file is part of libnbt++.
+ *
+ * libnbt++ 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.
+ *
+ * libnbt++ 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 libnbt++.  If not, see <http://www.gnu.org/licenses/>.
+ */
+#ifndef STREAM_READER_H_INCLUDED
+#define STREAM_READER_H_INCLUDED
+
+#include "endian_str.h"
+#include "tag.h"
+#include "tag_compound.h"
+#include <iosfwd>
+#include <memory>
+#include <stdexcept>
+#include <utility>
+
+#include "nbt++_export.h"
+
+namespace nbt
+{
+namespace io
+{
+
+///Exception that gets thrown when reading is not successful
+class NBT___EXPORT input_error : public std::runtime_error
+{
+    using std::runtime_error::runtime_error;
+};
+
+/**
+* @brief Reads a named tag from the stream, making sure that it is a compound
+* @param is the stream to read from
+* @param e the byte order of the source data. The Java edition
+* of Minecraft uses Big Endian, the Pocket edition uses Little Endian
+* @throw input_error on failure, or if the tag in the stream is not a compound
+*/
+NBT___EXPORT std::pair<std::string, std::unique_ptr<tag_compound>> read_compound(std::istream& is, endian::endian e = endian::big);
+
+/**
+* @brief Reads a named tag from the stream
+* @param is the stream to read from
+* @param e the byte order of the source data. The Java edition
+* of Minecraft uses Big Endian, the Pocket edition uses Little Endian
+* @throw input_error on failure
+*/
+NBT___EXPORT std::pair<std::string, std::unique_ptr<tag>> read_tag(std::istream& is, endian::endian e = endian::big);
+
+/**
+ * @brief Helper class for reading NBT tags from input streams
+ *
+ * Can be reused to read multiple tags
+ */
+class NBT___EXPORT stream_reader
+{
+public:
+    /**
+     * @param is the stream to read from
+     * @param e the byte order of the source data. The Java edition
+     * of Minecraft uses Big Endian, the Pocket edition uses Little Endian
+     */
+    explicit stream_reader(std::istream& is, endian::endian e = endian::big) noexcept;
+
+    ///Returns the stream
+    std::istream& get_istr() const;
+    ///Returns the byte order
+    endian::endian get_endian() const;
+
+    /**
+     * @brief Reads a named tag from the stream, making sure that it is a compound
+     * @throw input_error on failure, or if the tag in the stream is not a compound
+     */
+    std::pair<std::string, std::unique_ptr<tag_compound>> read_compound();
+
+    /**
+     * @brief Reads a named tag from the stream
+     * @throw input_error on failure
+     */
+    std::pair<std::string, std::unique_ptr<tag>> read_tag();
+
+    /**
+     * @brief Reads a tag of the given type without name from the stream
+     * @throw input_error on failure
+     */
+    std::unique_ptr<tag> read_payload(tag_type type);
+
+    /**
+     * @brief Reads a tag type from the stream
+     * @param allow_end whether to consider tag_type::End valid
+     * @throw input_error on failure
+     */
+    tag_type read_type(bool allow_end = false);
+
+    /**
+     * @brief Reads a binary number from the stream
+     *
+     * On failure, will set the failbit on the stream.
+     */
+    template<class T>
+    void read_num(T& x);
+
+    /**
+     * @brief Reads an NBT string from the stream
+     *
+     * An NBT string consists of two bytes indicating the length, followed by
+     * the characters encoded in modified UTF-8.
+     * @throw input_error on failure
+     */
+    std::string read_string();
+
+private:
+    std::istream& is;
+    const endian::endian endian;
+};
+
+template<class T>
+void stream_reader::read_num(T& x)
+{
+    endian::read(is, x, endian);
+}
+
+}
+}
+
+#endif // STREAM_READER_H_INCLUDED

depends/libnbtplusplus/include/io/stream_writer.h

@@ -0,0 +1,122 @@
+/*
+ * libnbt++ - A library for the Minecraft Named Binary Tag format.
+ * Copyright (C) 2013, 2015  ljfa-ag
+ *
+ * This file is part of libnbt++.
+ *
+ * libnbt++ 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.
+ *
+ * libnbt++ 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 libnbt++.  If not, see <http://www.gnu.org/licenses/>.
+ */
+#ifndef STREAM_WRITER_H_INCLUDED
+#define STREAM_WRITER_H_INCLUDED
+
+#include "tag.h"
+#include "endian_str.h"
+#include <iosfwd>
+
+#include "nbt++_export.h"
+
+namespace nbt
+{
+namespace io
+{
+
+/* Not sure if that is even needed
+///Exception that gets thrown when writing is not successful
+class output_error : public std::runtime_error
+{
+    using std::runtime_error::runtime_error;
+};*/
+
+/**
+* @brief Writes a named tag into the stream, including the tag type
+* @param key the name of the tag
+* @param t the tag
+* @param os the stream to write to
+* @param e the byte order of the written data. The Java edition
+* of Minecraft uses Big Endian, the Pocket edition uses Little Endian
+*/
+NBT___EXPORT void write_tag(const std::string& key, const tag& t, std::ostream& os, endian::endian e = endian::big);
+
+/**
+ * @brief Helper class for writing NBT tags to output streams
+ *
+ * Can be reused to write multiple tags
+ */
+class NBT___EXPORT stream_writer
+{
+public:
+    ///Maximum length of an NBT string (16 bit unsigned)
+    static constexpr size_t max_string_len = UINT16_MAX;
+    ///Maximum length of an NBT list or array (32 bit signed)
+    static constexpr uint32_t max_array_len = INT32_MAX;
+
+    /**
+     * @param os the stream to write to
+     * @param e the byte order of the written data. The Java edition
+     * of Minecraft uses Big Endian, the Pocket edition uses Little Endian
+     */
+    explicit stream_writer(std::ostream& os, endian::endian e = endian::big) noexcept:
+        os(os), endian(e)
+    {}
+
+    ///Returns the stream
+    std::ostream& get_ostr() const { return os; }
+    ///Returns the byte order
+    endian::endian get_endian() const { return endian; }
+
+    /**
+     * @brief Writes a named tag into the stream, including the tag type
+     */
+    void write_tag(const std::string& key, const tag& t);
+
+    /**
+     * @brief Writes the given tag's payload into the stream
+     */
+    void write_payload(const tag& t) { t.write_payload(*this); }
+
+    /**
+     * @brief Writes a tag type to the stream
+     */
+    void write_type(tag_type tt) { write_num(static_cast<int8_t>(tt)); }
+
+    /**
+     * @brief Writes a binary number to the stream
+     */
+    template<class T>
+    void write_num(T x);
+
+    /**
+     * @brief Writes an NBT string to the stream
+     *
+     * An NBT string consists of two bytes indicating the length, followed by
+     * the characters encoded in modified UTF-8.
+     * @throw std::length_error if the string is too long for NBT
+     */
+    void write_string(const std::string& str);
+
+private:
+    std::ostream& os;
+    const endian::endian endian;
+};
+
+template<class T>
+void stream_writer::write_num(T x)
+{
+    endian::write(os, x, endian);
+}
+
+}
+}
+
+#endif // STREAM_WRITER_H_INCLUDED