/*
* 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 .
*/
#ifndef TAG_ARRAY_H_INCLUDED
#define TAG_ARRAY_H_INCLUDED
#include "crtp_tag.h"
#include
#include
#include "nbt++_export.h"
namespace nbt
{
///@cond
namespace detail
{
///Meta-struct that holds the tag_type value for a specific array type
template struct get_array_type
{ static_assert(sizeof(T) != sizeof(T), "Invalid type paramter for tag_primitive, can only use byte or int"); };
template<> struct get_array_type : public std::integral_constant {};
template<> struct get_array_type : public std::integral_constant {};
}
///@cond
/**
* @brief Tag that contains an array of byte or int values
*
* Common class for tag_byte_array and tag_int_array.
*/
template
class NBT___EXPORT tag_array final : public detail::crtp_tag>
{
public:
//Iterator types
typedef typename std::vector::iterator iterator;
typedef typename std::vector::const_iterator const_iterator;
///The type of the contained values
typedef T value_type;
///The type of the tag
static constexpr tag_type type = detail::get_array_type::value;
///Constructs an empty array
tag_array() {}
///Constructs an array with the given values
tag_array(std::initializer_list init): data(init) {}
tag_array(std::vector&& vec) noexcept: data(std::move(vec)) {}
///Returns a reference to the vector that contains the values
std::vector& get() { return data; }
const std::vector& get() const { return data; }
/**
* @brief Accesses a value by index with bounds checking
* @throw std::out_of_range if the index is out of range
*/
T& at(size_t i);
T at(size_t i) const;
/**
* @brief Accesses a value by index
*
* No bounds checking is performed.
*/
T& operator[](size_t i) { return data[i]; }
T operator[](size_t i) const { return data[i]; }
///Appends a value at the end of the array
void push_back(T val) { data.push_back(val); }
///Removes the last element from the array
void pop_back() { data.pop_back(); }
///Returns the number of values in the array
size_t size() const { return data.size(); }
///Erases all values from the array.
void clear() { data.clear(); }
//Iterators
iterator begin() { return data.begin(); }
iterator end() { return data.end(); }
const_iterator begin() const { return data.begin(); }
const_iterator end() const { return data.end(); }
const_iterator cbegin() const { return data.cbegin(); }
const_iterator cend() const { return data.cend(); }
void read_payload(io::stream_reader& reader) override;
/**
* @inheritdoc
* @throw std::length_error if the array is too large for NBT
*/
void write_payload(io::stream_writer& writer) const override;
private:
std::vector data;
};
template bool operator==(const tag_array& lhs, const tag_array& rhs)
{ return lhs.get() == rhs.get(); }
template bool operator!=(const tag_array& lhs, const tag_array& rhs)
{ return !(lhs == rhs); }
//Typedefs that should be used instead of the template tag_array.
typedef tag_array tag_byte_array;
typedef tag_array tag_int_array;
}
#endif // TAG_ARRAY_H_INCLUDED